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

[CAT-814] Clean up documentation for Readme #278

Merged
merged 14 commits into from
Nov 8, 2023
Merged

Conversation

meghanhickey
Copy link
Contributor

Summary

  • remove example rst files, since we want to put examples in recipes
  • categorize doc pages as one of "classes" or "types" and sort them into folders
  • remove specific markdown links that won't work in Readme, and edit other so they will work

@@ -1,21 +1,7 @@
******************************
indicoio Python Client Library
Indico Python Client Library
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Should we add any intro or guidance on using the guide here? Probably worth asking technical writing?

@meghanhickey meghanhickey merged commit 69e31ac into readme-docs Nov 8, 2023
1 check passed
@meghanhickey meghanhickey deleted the meghan/cat-814 branch November 8, 2023 16:26
goatrocks added a commit that referenced this pull request Feb 8, 2024
* [CAT-803] Add dockerfile for container that generates markdown docs (#265)

* added dockerfile for generating markdown from rst, and updated sphinx config to generate markdown instead of html

* moving logic for creating docs to separate script

* [CAT-806] adding github pr script (#272)

* adding github pr script

* [CAT-806] generate frontmatter for markdown files (#275)

* run script to add frontmatter yaml

* wip

* change base branch

* save harness pipeline yaml

* only mkdir if it doesn't already exist

---------

Co-authored-by: MC <meg.cahill@indico.io>
Co-authored-by: meghanhickey <meghan.hickey@indico.io>

* [CAT-814] Clean up documentation for Readme (#278)

* adding github pr script

* run script to add frontmatter yaml

* wip

* change base branch

* save harness pipeline yaml

* clean up rst files

* [CAT-803] Add dockerfile for container that generates markdown docs (#265)

* added dockerfile for generating markdown from rst, and updated sphinx config to generate markdown instead of html

* moving logic for creating docs to separate script

* move dockerfile and scripts for building docs to indico-readme repo

* WIP

* adding github pr script

* adding script to build docs

* use branch of indico-readme

* edit doc links so they work in readme; remove uninformationive Raises from docstrings

* edit docstrings

---------

Co-authored-by: MC <meg.cahill@indico.io>

* update harness pipeline

* address brigid's comments

* more responses to brigid comments

---------

Co-authored-by: micah cahill <micah.cahill@indicodata.ai>
Co-authored-by: MC <meg.cahill@indico.io>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

2 participants