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

Fix code formatting for data capture getting started #2726

Open
wants to merge 10 commits into
base: master
Choose a base branch
from

Conversation

utzcoz
Copy link
Contributor

@utzcoz utzcoz commented Nov 17, 2024

IMPORTANT: All PRs must be linked to an issue (except for extremely trivial and straightforward changes).

Straightforward changes for documentation format, so it doesn't attach any issue.

Description

Mkdocs doesn't support fenced code block in number list,
so this CL changes number list to unordered lists and
removes indent for fenced code block to make it work.

This Cl also fixes running error of build-docs.bash on Ubuntu 22.04 that I faced
by updating setuptools before building mkdocs.

Alternative(s) considered
Not.

Type
Documentation

Screenshots (if applicable)

Checklist

  • I have read and acknowledged the Code of conduct.
  • I have read the Contributing page.
  • I have signed the Google Individual CLA, or I am covered by my company's Corporate CLA.
  • I have discussed my proposed solution with code owners in the linked issue(s) and we have agreed upon the general approach.
  • I have run ./gradlew spotlessApply and ./gradlew spotlessCheck to check my code follows the style guide of this project.
  • I have run ./gradlew check and ./gradlew connectedCheck to test my changes locally.
  • I have built and run the demo app(s) to verify my change fixes the issue and/or does not break the demo app(s).

The default setuptools installed by pipenv has compatibility
issue foir some Ubuntu 24.04, and this CL adds a new
command to update setuptools to latest version to ensure
mkdocs and its dependency installation work without errors.

Signed-off-by: utzcoz <[email protected]>
Mkdocs doesn't support fenced code block in number list,
so this CL changes number list to unordered lists and
removes indent for fenced code block to make it work.

Signed-off-by: utzcoz <[email protected]>
@utzcoz utzcoz requested a review from a team as a code owner November 17, 2024 05:11
@utzcoz utzcoz requested a review from aditya-07 November 17, 2024 05:11
Copy link
Collaborator

@jingtang10 jingtang10 left a comment

Choose a reason for hiding this comment

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

Thanks so much for this @utzcoz !

docs/use/SDCL/Getting-Started.md Outdated Show resolved Hide resolved
docs/use/SDCL/Getting-Started.md Outdated Show resolved Hide resolved
docs/use/SDCL/Getting-Started.md Outdated Show resolved Hide resolved
@jingtang10 jingtang10 enabled auto-merge (squash) November 28, 2024 00:05
@utzcoz
Copy link
Contributor Author

utzcoz commented Nov 28, 2024

@jingtang10 Thanks for your reviewing. Looks like it requires your approval to make CI passed.

@utzcoz
Copy link
Contributor Author

utzcoz commented Dec 19, 2024

Hi @jingtang10 Could you help to approve and merge it? Thanks.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
Status: PR under Review
Development

Successfully merging this pull request may close these issues.

2 participants