You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
This could create a clean and easier to read source for documentation, and since it is built directly off markdown in the github repo, would not require a lot of extra effort once configured.
Create a separate repo, name has to match org name: COVID-19-electronic-health-system.github.io, contains all the documentation for the organization.
Create a gh-pages branch in the .github repo, that contains all the documentation for the organization.
Create a gh-pages branch in the Corona-tracker repo, that contains all the documentation for Corona-tracker, and follow the same format for each repo.
There are options to attach this to one of our domains as well, such as docs.coronatracker.me.
It really depends on if we want the documentation to be centered on the organization or centered on the product, and each option can expand as the orgnization/project(s) grow.
Possible Alternatives
Leave as-is, which includes documentation presented in markdown files, typically the README.md file of a folder. The current documentation flows: Org Level --> Repo Level --> Folder Level and should contain back-links to the top.
Additional Context
The first goal of the documentation is to be easily accessible and easy to navigate within Github itself. This would translate well to a website.
The flow of information should be considered whenever creating documentation, emphasizing links to canonical references when possible, and at least linking back one level in the folder structure like a bread crumb.
The text was updated successfully, but these errors were encountered:
Summary
Per @tesla809, we should add a Github pages website for documentation.
Motivation
This could create a clean and easier to read source for documentation, and since it is built directly off markdown in the github repo, would not require a lot of extra effort once configured.
I could see this working out a few ways:
Create a separate repo, name has to match org name:
COVID-19-electronic-health-system.github.io
, contains all the documentation for the organization.Create a
gh-pages
branch in the .github repo, that contains all the documentation for the organization.Create a
gh-pages
branch in the Corona-tracker repo, that contains all the documentation for Corona-tracker, and follow the same format for each repo.There are options to attach this to one of our domains as well, such as
docs.coronatracker.me
.It really depends on if we want the documentation to be centered on the organization or centered on the product, and each option can expand as the orgnization/project(s) grow.
Possible Alternatives
Leave as-is, which includes documentation presented in markdown files, typically the README.md file of a folder. The current documentation flows:
Org Level --> Repo Level --> Folder Level
and should contain back-links to the top.Additional Context
The first goal of the documentation is to be easily accessible and easy to navigate within Github itself. This would translate well to a website.
The flow of information should be considered whenever creating documentation, emphasizing links to canonical references when possible, and at least linking back one level in the folder structure like a bread crumb.
The text was updated successfully, but these errors were encountered: