Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Improve Cosmos docs #1225

Open
3 of 9 tasks
tatiana opened this issue Sep 25, 2024 · 1 comment
Open
3 of 9 tasks

Improve Cosmos docs #1225

tatiana opened this issue Sep 25, 2024 · 1 comment
Assignees
Labels
area:docs Relating to documentation, changes, fixes, improvement

Comments

@tatiana
Copy link
Collaborator

tatiana commented Sep 25, 2024

(Written by @cmarteepants):

This ticket aims make our docs more beginner friendly. This includes have more information about the problem that Cosmos aims to solve, adding more in-depth explanations for core concepts, and reorganizing content to make features more discoverable.

ToDo's:

  • Home / index: ([DOCS]: Adds Welcome Section and "What Is Cosmos" Blurb to Home Page #1251)
    • Add welcome text, and brief explanation for what Cosmos is and problem it tries to solve
    • Add a call to action to join the community
    • (Potentially) Explain doc layout
  • Create a dedicated "First Steps" section with:
    • Overview: Deeper explanation for what Cosmos is, benefits, and example usage, and
    • Quick Start: Simple example that anybody can run locally (either using Astro CLI, or Airflow OSS)
  • Create an Installation Section (revamp Getting Started)
  • Create an Explore Concepts section to explain the different types of configs (Project, Profile, Execution, Render) and features (generating and hosting docs, only running a subset of dbt resources, scheduling options)
@cmarteepants
Copy link
Collaborator

From @tatiana: Another thing we may want to address is to remove the duplicate between README.md and index.rst
#1221

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area:docs Relating to documentation, changes, fixes, improvement
Projects
None yet
Development

No branches or pull requests

2 participants