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 configuration examples to readme #42

Merged
merged 6 commits into from
Mar 12, 2021

Conversation

claby2
Copy link
Member

@claby2 claby2 commented Mar 5, 2021

This PR primarily adds configuration examples to README.md and some general documentation improvements.

@claby2 claby2 requested review from virchau13 and priime0 March 5, 2021 10:34
Copy link
Member

@virchau13 virchau13 left a comment

Choose a reason for hiding this comment

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

You may want to also show that you can access files in the root by starting your paths with /.

README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
README.md Outdated Show resolved Hide resolved
@claby2
Copy link
Member Author

claby2 commented Mar 5, 2021

You may want to also show that you can access files in the root by starting your paths with /.

I don't think this is a good idea to include right now. This functionality is currently untested and also goes against the intended functionality.

@claby2 claby2 requested a review from virchau13 March 5, 2021 13:39
README.md Show resolved Hide resolved
README.md Outdated

Variant expressions, denoted with brackets (`[]`), are a shorthand way to set multiple paths.

Symlink:
Copy link
Member

Choose a reason for hiding this comment

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

This should be changed to "This code can be shortened by using a variant expression..." or similar.


Match expressions, denoted with braces (`{}`), allow to conditionally sync files based on a system's operating system and host.

Conditionally symlink by os and host:
Copy link
Member

Choose a reason for hiding this comment

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

Explain what this does by giving specific examples using OS & host.

Linting:

$ cargo check
$ cargo clippy --all-targets --all-features
Copy link
Member

Choose a reason for hiding this comment

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

You may want to add that our automatic CI checks fmt, clippy, and test.

Copy link
Member

@virchau13 virchau13 left a comment

Choose a reason for hiding this comment

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

You may want to also add somewhere that you can use backslashes to escape special characters, e.g. .config/badly\ named\[dir\/\}/config.

README.md Outdated
$ git clone [email protected]:plamorg/ambit.git
$ cd ambit
$ cargo install --path .
Symlink `${HOME}/host.txt -> ${AMBIT_REPO_PATH}/a/repo.txt`:
Copy link
Member

Choose a reason for hiding this comment

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

The -> should not be part of the monospaced font.

Suggested change
Symlink `${HOME}/host.txt -> ${AMBIT_REPO_PATH}/a/repo.txt`:
Symlink `${HOME}/host.txt` to `${AMBIT_REPO_PATH}/a/repo.txt`:

README.md Outdated
Comment on lines 98 to 101
* `${HOME}/.config/bat/bat.conf -> ${AMBIT_REPO_PATH}/.config/bat/bat.conf`
* `${HOME}/.config/nvim/init.vim -> ${AMBIT_REPO_PATH}/.config/nvim/init.vim`
* `${HOME}/.config/kitty/kitty.conf -> ${AMBIT_REPO_PATH}/.config/kitty/kitty.conf`
* `${HOME}/.config/kitty/theme.conf -> ${AMBIT_REPO_PATH}/.config/kitty/theme.conf`
Copy link
Member

Choose a reason for hiding this comment

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

Same with the ->s here.

README.md Outdated

.config/ambit/config.ambit;

#### Variant Expression
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
#### Variant Expression
#### Variant expressions

@virchau13 virchau13 merged commit 2ed75e8 into plamorg:master Mar 12, 2021
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants