Our docs.talawa.io website has a major deficiency in that it focuses only on our developer community. It does not provide any documentation for either administrators or end users. It would also be useful to have a blog.
We want to make the following changes.
Maintain the current home page with updated links, namely:
User Guide – Directing to docs.talawa.io/users
This must direct to a “User guide coming soon” page. We will add the rest of the pages later.
This section must have its own completely separate left hand side menuing system.
The documentation for this section must be located under the talawa-docs/users directory or some other unique name that minimizes confusion with other document trees.
Admin Guide - Directing to docs.talawa.io/admins
This must direct to a “Admin guide coming soon” page. We will add the rest of the pages later.
This section must have its own completely separate left hand side menuing system.
The documentation for this section must be located under the talawa-docs/admins directory or some other unique name that minimizes confusion with other document trees.
Developer Guide - Directing to our existing docs.talawa.io/docs URI
The current left hand side menuing system must be maintained
The documentation for this section must be located under the existing talawa-docs/docs directory
All CI/CD integrations with other repos must not break. These integrations must operate and update the correct document trees when updated. For ease of implementation you may consider using the existing directory structure for these integrations.
Our docs.talawa.io website has a major deficiency in that it focuses only on our developer community. It does not provide any documentation for either administrators or end users. It would also be useful to have a blog.
We want to make the following changes.
Maintain the current home page with updated links, namely:
We have done some research and discovered that it is possible to have multiple document URIs in a single docusaurus instance:
Please work with @tasneemkoushar and @anwersayeed who have worked extensively with our CI/CD integrations. Ask to be assigned this task by them.