-
Notifications
You must be signed in to change notification settings - Fork 6
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
docs docs docs! #63
Comments
My opinion is we might as well use GitHub pages since we are using GitHub... regardless its syntax is markdown so we can always change it pretty simply in the future if needed @patrickserrano I remember you saying you would be interested in this 😜 |
I'll setup a pipeline for GitHub Pages with Hugo with an empty shell -- and hopefully @patrickserrano will start writing docs in it |
@patrickserrano Any ideas on what to start with? lets create the structure and get things setup in markdown. nothing stopping us from moving forward with that 🥰 |
@sjk07 what about something like this?
|
@patrickserrano crap totally missed this, you should have bugged me lol! This looks good. we should think of a way to show all things that are and are not platform specific. It would be nice to only show the functionality available to the user |
@sjk07 maybe once we have the docs put together we can look at placing the platform specific items in collapsible elements which we can auto-expand for the current platform? |
@patrickserrano / @sjk07 : couple of ideas:
Let me know which ones you would like to go with; I'm happy to setup the skeleton and deployment to GitHub Pages to make it easier to just start writing content. |
@dmccaffery I really like the MKDocs site. That said, do you think that Hugo is more widely used which would make it easier for new contributions? If you don't think it matters lets go with the MKDocs theme, otherwise Docsy works too. |
@patrickserrano @dmccaffery I like the idea of using hugo. only because I don't like python 😜 That being said its important to keep in mind what types of tech we are using and have to support. we have:
I have wanted to move toward using golang for other poject's but no real skin in the game yet. end of the day we need a static site generator that take markdown and outputs html. Any reasons we should not use Hugo? |
Let's figure out how we want to implement docs. There is enough going on that a README isn't enough to contain everything and I think it makes sense to build out some better docs, but how to do it?
Couple of options:
Prompt is simple and composable enough that it should be possible to document everything in the wiki with enough organisation for folks to find what they need.
I think GitHub Pages is a better alternative if we want to seamlessly integrate prompt docs with docs from any other repos in the org. It's also better if you want to force docs as part of the code; requiring it for PRs.
This decision should not come from me, but I did want to add it as an issue so it's tracked (topic keeps coming up).
The text was updated successfully, but these errors were encountered: