-
Notifications
You must be signed in to change notification settings - Fork 43
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
Organize docs in more suitable layout #856
Conversation
The current docs structure focuses on someone setting up a server and then running medic, whereas with us running a publically available mediator instance, its fair to say more users will just download medic and then want to get started, without installing a their own server Signed-off-by: Luke Hinds <luke@stacklok.com>
Signed-off-by: Luke Hinds <luke@stacklok.com>
Signed-off-by: Luke Hinds <luke@stacklok.com>
Signed-off-by: Luke Hinds <luke@stacklok.com>
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I think we're using yarn
, so you don't want to check in package-lock.json
at all.
@@ -27,14 +27,14 @@ | |||
// @ts-check | |||
const fs = require('fs'); |
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
Do we want to just use autogenerated sidebars, which would look like:
module.exports = {
autogenerated_sidebar: [
{
type: 'autogenerated',
dirName: './docs'
]
};
There was a problem hiding this comment.
Choose a reason for hiding this comment
The reason will be displayed to describe this comment to others. Learn more.
I am not sure its possible to silo into individual categories then
The current docs structure focuses on someone setting up a server and then running medic, whereas with us running a publicly available mediator instance, its fair to say more users will just download medic and then want to get started, without installing a their own server