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

docs: add a README to the Nixfiles, improve formatting #11472

Merged
merged 1 commit into from
Jul 29, 2023

Conversation

agilgur5
Copy link
Member

@agilgur5 agilgur5 commented Jul 28, 2023

Motivation

There is already documentation for this, so just link to the existing docs

Modifications

  • add a README with a one-line link to dev/nix/

  • also improve some grammar and formatting in the Nix docs

    • use code backticks for all commands
    • use markdown convention of using 1. for all items of an ordered list and having the renderer determine the numbering
    • use the name of the doc (Running Locally) instead of "this"
    • separate run-on sentence

Verification

Double-checked that the relative link worked locally

- there is already documentation for this, so just link to the existing docs
  - just handy to have a back-link for those less familiar with Nix and who stumble upon it

- also improve some grammar and formatting in the Nix docs
  - use code backticks for all commands
  - use markdown convention of using `1.` for all items of an ordered list and having the renderer determine the numbering
  - use the name of the doc (Running Locally) instead of "this"
    - more consistent with the rest of the docs
    - also merge 1 and 2 as they're both mentioned in Running Locally
  - separate run-on sentence

Signed-off-by: Anton Gilgur <agilgur5@gmail.com>
@terrytangyuan
Copy link
Member

cc @isubasinghe

@sarabala1979 sarabala1979 merged commit 20b5814 into argoproj:master Jul 29, 2023
24 checks passed
@sarabala1979
Copy link
Member

@isubasinghe sorry I didn't realize Terry tagged you. Please review and comment it.

@agilgur5 agilgur5 deleted the docs-nix-readme branch July 29, 2023 03:06
@agilgur5
Copy link
Member Author

agilgur5 commented Jul 29, 2023

I didn't change any Nixfiles or real content (mostly formatting/style), so thought it'd be ok for anyone to review. Otherwise would cc @isubasinghe myself who knows Nix better than I currently do

@isubasinghe
Copy link
Member

LGTM since its just markdown

@agilgur5 agilgur5 added type/dependencies PRs and issues specific to updating dependencies area/docs Incorrect, missing, or mistakes in docs area/build Build or GithubAction/CI issues labels Sep 13, 2023
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
area/build Build or GithubAction/CI issues area/docs Incorrect, missing, or mistakes in docs type/dependencies PRs and issues specific to updating dependencies
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants