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

📝(project) add base documentation #60

Merged
merged 1 commit into from
Feb 25, 2021
Merged

📝(project) add base documentation #60

merged 1 commit into from
Feb 25, 2021

Conversation

jmaupetit
Copy link
Contributor

@jmaupetit jmaupetit commented Feb 12, 2021

Purpose

Now that the project is used in production, we need to explain key concepts and document commands and backends.

Proposal

  • integrate mkdocs
  • automate documentation build in the CI
  • document backends
  • document commands (should be automated given command docstrings)
  • write tutorial postponed (will be handled in another PR)
  • improve developer user guide

CHANGELOG.md Show resolved Hide resolved
@jmaupetit jmaupetit force-pushed the add-docs branch 4 times, most recently from 95aaf52 to c88f8a0 Compare February 23, 2021 10:23
@github-pages github-pages bot temporarily deployed to github-pages February 23, 2021 10:51 Inactive
@jmaupetit jmaupetit marked this pull request as ready for review February 23, 2021 15:58
Copy link
Collaborator

@SergioSim SergioSim left a comment

Choose a reason for hiding this comment

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

Beautiful Documentation! Thanks a lot Julien)

.env.dist Show resolved Hide resolved
Makefile Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
docs/backends.md Outdated Show resolved Hide resolved
docs/contribute.md Outdated Show resolved Hide resolved
docs/index.md Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/models/index.md Outdated Show resolved Hide resolved
@jmaupetit
Copy link
Contributor Author

Thank you for your feedback @SergioSim ❤️

Copy link
Member

@quitterie-lcs quitterie-lcs left a comment

Choose a reason for hiding this comment

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

Congrats for this comprehensive work!
There is still a very very small issue that comes from the automated update for command and model documentations:

  • sometimes, there is the description sentence with a point (for example in Open edx events > base > baseContextModel)

Represents the base context model inherited by all event contexts.

  • and sometimes not (for example in ralph > extract)

Extract input events from a container format using a dedicated parser

README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
docs/backends.md Outdated Show resolved Hide resolved
docs/backends.md Outdated Show resolved Hide resolved
docs/contribute.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/index.md Outdated Show resolved Hide resolved
docs/models/index.md Outdated Show resolved Hide resolved
@jmaupetit
Copy link
Contributor Author

There is still a very very small issue that comes from the automated update for command and model documentations

You are totally right, we need to stay consistent. IMO this should be addressed in a new PR.

@jmaupetit
Copy link
Contributor Author

@SergioSim & @quitterie-lcs I've addressed all your comments in separated fixup commits. Is there any chance that you have time for a last review (and validation)? 🙏

docs/index.md Outdated Show resolved Hide resolved
Copy link
Member

@quitterie-lcs quitterie-lcs left a comment

Choose a reason for hiding this comment

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

Let's go!

Now that the project is used in production, we need to explain key
concepts and document commands and backends.
@jmaupetit jmaupetit deleted the add-docs branch February 25, 2021 16:11
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants