Skip to content

docs(contributing): basic fixes#1418

Merged
samsja merged 5 commits into
mainfrom
docs-contributing-fix
Apr 18, 2023
Merged

docs(contributing): basic fixes#1418
samsja merged 5 commits into
mainfrom
docs-contributing-fix

Conversation

@alexcg1

@alexcg1 alexcg1 commented Apr 18, 2023

Copy link
Copy Markdown
Contributor

General tidy up

Signed-off-by: Alex C-G alexcg@outlook.com

alexcg1 added 3 commits April 18, 2023 13:20
Signed-off-by: Alex C-G <alexcg@outlook.com>
Signed-off-by: Alex C-G <alexcg@outlook.com>
Signed-off-by: Alex C-G <alexcg@outlook.com>
@alexcg1 alexcg1 requested a review from samsja April 18, 2023 11:23
Comment thread CONTRIBUTING.md Outdated
Comment on lines 338 to 344
#### [MyST](https://myst-parser.readthedocs.io/en/latest/) Elements Usage

1. Use the `{tab}` element to show multiple ways of doing one thing. [Example](https://docarray.jina.ai/fundamentals/document/#document)
2. Use the `{admonition}` boxes with care.
3. Use `{dropdown}` to hide optional content, such as long code snippets or console output.


Note: Example code in the documentation should also follow our [code style conventions]().

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

you u remove this section. it is not relevant anymore as we don't use myst

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Roger that. What about the [code style conventions]()? There's no URL

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

you can remove the link, lets just say follow our code style

Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated
Comment thread CONTRIBUTING.md Outdated

@samsja samsja left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

need to change some part about mkdocs

alexcg1 and others added 2 commits April 18, 2023 13:45
Co-authored-by: samsja <55492238+samsja@users.noreply.github.com>
Signed-off-by: Alex Cureton-Griffiths <alexcg1@users.noreply.github.com>
Signed-off-by: Alex C-G <alexcg@outlook.com>
@github-actions

Copy link
Copy Markdown

📝 Docs are deployed on https://ft-docs-contributing-fix--jina-docs.netlify.app 🎉

@samsja samsja merged commit 3eb7511 into main Apr 18, 2023
@samsja samsja deleted the docs-contributing-fix branch April 18, 2023 14:41
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants