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

Update docs with tutorials and how-to sections #569

Merged

Conversation

guilhermeleobas
Copy link
Contributor

@guilhermeleobas guilhermeleobas commented Jun 30, 2023

This pull request adds two new sections to RBC ReadTheDocs page:

  • How To
  • Tutorials

This refactoring aims to enhance the clarity and structure of the text, and it is based on diataxis guide on documentation. How-to guides are supposed to be concise and provide direct answers to specific questions (i.e. "How to connect to the HeavyDB server"). On the other hand, tutorials should be more comprehensive and in-depth exploration of a subject.

@guilhermeleobas guilhermeleobas added the documentation Document a feature label Jun 30, 2023
@guilhermeleobas guilhermeleobas self-assigned this Jun 30, 2023
@guilhermeleobas guilhermeleobas force-pushed the guilhermeleobas/update-docs branch 2 times, most recently from 50cf2e6 to 6244b29 Compare July 3, 2023 17:02
@guilhermeleobas guilhermeleobas marked this pull request as ready for review July 3, 2023 17:08
@guilhermeleobas guilhermeleobas marked this pull request as draft July 3, 2023 17:08
@guilhermeleobas guilhermeleobas marked this pull request as ready for review July 10, 2023 18:55
Copy link
Contributor

@brenocfg brenocfg left a comment

Choose a reason for hiding this comment

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

Pointed out as many suggestions/typos I could find in the raw files. I'll go over the rendered docs in a bit and see if I spot anything else.

doc/howtos/column.md Outdated Show resolved Hide resolved
doc/howtos/devices.md Outdated Show resolved Hide resolved
doc/howtos/external_functions.md Outdated Show resolved Hide resolved
doc/howtos/geo.md Outdated Show resolved Hide resolved
doc/howtos/geo.md Outdated Show resolved Hide resolved
doc/howtos/manager.md Outdated Show resolved Hide resolved
doc/howtos/udf.md Outdated Show resolved Hide resolved
doc/tutorials.md Outdated Show resolved Hide resolved
Copy link
Contributor

@brenocfg brenocfg left a comment

Choose a reason for hiding this comment

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

LGTM!

@guilhermeleobas guilhermeleobas merged commit dcfc843 into heavyai:main Jul 11, 2023
22 checks passed
@guilhermeleobas guilhermeleobas deleted the guilhermeleobas/update-docs branch July 11, 2023 18:13
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Document a feature
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants