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

Create new documentation site based on README #232

Merged
merged 3 commits into from
Jul 17, 2023

Conversation

etekweb
Copy link
Contributor

@etekweb etekweb commented Jun 15, 2023

Adds a new documentation site based on the current README.md file. This approach is much easier to navigate than the current docs since you can use the navigation bar on the left-hand side (as discussed in #95).

Note
To publish the documentation, a project maintainer will need to set up GitHub Pages to point to the docs/ folder in the repo. See here for instructions.

Future Development

After the documentation site is published, the main repo README.md file can then be dramatically simplified to just contain the basic project info and a link to the documentation site.

Also, it would probably be useful to ultimately divide the README file into multiple subpages. This will reduce the overall amount of information on first load, as well as simplifying future updates to the documentation.

@appy-one
Copy link
Owner

Awesome @etekweb I'll take a look!

@appy-one appy-one self-assigned this Jul 17, 2023
@appy-one appy-one added enhancement New feature or request documentation labels Jul 17, 2023
@appy-one appy-one merged commit df3372b into appy-one:master Jul 17, 2023
@appy-one
Copy link
Owner

The docs are now live at https://appy-one.github.io/acebase/
Thanks for your contribution @etekweb!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation enhancement New feature or request
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants