The next iteration on this epic is to improve the look, feel, and layout of our documentation. Decisions made for this epic: * Documentation will live at https://docs.meltano.com * This is everything from `Getting Started` on down in the current documentation * The Mission, Focus, Roadmap, History, Values will all live in the handbook with prominent links from the updated website. Cross-links from the documentation will exist as well. https://gitlab.com/meltano/handbook/-/issues/31 * SDK Documentation will be migrated to https://docs.meltano.com/sdk - we have the option to do https://docs.meltano.com/singer/sdk if we want * The Hub will contain information about all of the plugins, but anything about _how_ to use them will live on the docs site. We are migrating to Jekyll for the docs site. Launch Date - Week of the 13th with a concurrent blog post to go out. The content of the documentation will continue to be iterated on with a heavy focus on intention-based documentation, i.e. what are you trying to accomplish? https://documentation.divio.com/ is an excellent resource for parsing the kinds of documentation. Decisions still to be made: * Where will discovery.yml live? * api.meltano.com/discover.yml? * discovery.meltano.com <-- I kind of like that. ### Examples of Documentation we like * [Dagster](https://docs.dagster.io/) * [Column](https://column.com/docs/guides) * [dbt](https://docs.getdbt.com/) * [Airflow](https://airflow.apache.org/docs/apache-airflow/stable/index.html) * [Auth0](https://auth0.com/docs/) - especially the diagram ### Examples of Documentation we do not like * [SQLAlchemy](https://www.sqlalchemy.org/library.html) ### Examples of Misc things we like * [This interactive menu sidebar](https://lab.hakim.se/progress-nav/) * [The docs nav item on PostHog](https://posthog.com/)