docs markdown fixes & author privacy on screenshot #149

Closed
ACyprus wants to merge 7 commits from devel into devel
ACyprus commented 2022-07-11 13:13:48 +02:00 (Migrated from github.com)

This PR

  • applies some minor typo, grammatical, formatting fixes the the docs markdown
  • obscures author details in the neutron-plotter folder screenshot
  • does not includes changes that were discussed/rejected on Discord during the previous PR
### This PR - applies some minor typo, grammatical, formatting fixes the the docs markdown - obscures author details in the neutron-plotter folder screenshot - does not includes changes that were discussed/rejected on Discord during the [previous PR](https://github.com/alterNERDtive/VoiceAttack-profiles/pull/137)
alterNERDtive (Migrated from github.com) requested changes 2022-07-11 13:25:56 +02:00
alterNERDtive (Migrated from github.com) left a comment

I can’t comment on the image file, but a) good spot! and b) please put a black rectangle there :)

I can’t comment on the image file, but a) good spot! and b) please put a _black_ rectangle there :)
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:20:55 +02:00

I believe the correct way to do this would be configuration/EliteAttack.md#settings.

Depending on the editor / IDE you’re using that might complain, but mkdocs (with roamlinks plugin) will resolve it just fine.

I believe the correct way to do this would be `configuration/EliteAttack.md#settings`. Depending on the editor / IDE you’re using that might complain, but mkdocs (with roamlinks plugin) will resolve it just fine.
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:17:03 +02:00

This seems to be a bit wider than 80 characters!

This seems to be a bit wider than 80 characters!
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:22:09 +02:00

Same here, should link to requirements.md.

Same here, should link to `requirements.md`.
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:24:55 +02:00

That link here does work. Is it about the ugly # in the text? :)

That link here does work. Is it about the ugly `#` in the text? :)
alterNERDtive commented 2022-07-11 13:31:08 +02:00 (Migrated from github.com)

Oh and considering there is a merge commit in this pull request you should probably rebase this on my devel branch again.

Generally it’s a good idea to create a specific branch for work on a pull request, makes the inevitable rebasing easier.

Oh and considering there is a merge commit in this pull request you should probably rebase this on my `devel` branch again. Generally it’s a good idea to create a specific branch for work on a pull request, makes the inevitable rebasing easier.
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:33:01 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:33:01 +02:00

I checked without the url in place at the time, it's below 80 so the wrapping should look good on the page.

I can change if needed though.

I checked without the url in place at the time, it's below 80 so the wrapping should look good on the page. I can change if needed though.
alterNERDtive (Migrated from github.com) reviewed 2022-07-11 13:34:34 +02:00
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:34:33 +02:00

Yeah, the character limit is for pretty printing the source file. Rendered text will flow based on the style sheet anyway.

Yeah, the character limit is for pretty printing the _source_ file. Rendered text will flow based on the style sheet anyway.
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:36:33 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:36:33 +02:00

I checked it earlier using the mkdocs linked preview tool and seemed ok, but you're right, I'll add the page too for clarity in a moment.

I added the parent directory dots because the original link is broken, I have no way to test those though according to the mkdocs docs they "should" work OK. lmk.

I checked it earlier using the mkdocs [linked preview tool](https://daringfireball.net/projects/markdown/dingus) and seemed ok, but you're right, I'll add the page too for clarity in a moment. I added the parent directory dots because the original link is broken, I have no way to test those though according to the mkdocs docs they "should" work OK. lmk.
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:40:11 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:40:11 +02:00

Yup, that's right. We could make it Installing#Include Profiles I guess. Other pages use such a format when they refer to a different page though.

What's your preference? Revert?

Yup, that's right. We could make it `Installing#Include Profiles` I guess. Other pages use such a format when they refer to a different page though. What's your preference? Revert?
alterNERDtive (Migrated from github.com) reviewed 2022-07-11 13:40:40 +02:00
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:40:40 +02:00

To be clear, your change does work. It’s just not … by the book, and will break if the site layout changes.

To be clear, your change does work. It’s just not … by the book, and will break if the site layout changes.
alterNERDtive (Migrated from github.com) reviewed 2022-07-11 13:42:17 +02:00
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:42:17 +02:00

Nah, just keep the change you did. Personally I don’t mind the # that much, but it doesn’t belong there.

Also fun fact, I thought clicking “resolve conversation” would submit the comment I wrote, but guess what …

Nah, just keep the change you did. Personally I don’t mind the `#` that much, but it doesn’t belong there. Also fun fact, I thought clicking “resolve conversation” would submit the comment I wrote, but guess what …
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:44:53 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:44:53 +02:00

Resolved by 7564176437

Resolved by https://github.com/alterNERDtive/VoiceAttack-profiles/pull/149/commits/75641764371a5661131b47222393894ef407f13e
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:45:13 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:45:13 +02:00

Resolved by a0b4bd621f

Resolved by https://github.com/alterNERDtive/VoiceAttack-profiles/pull/149/commits/a0b4bd621ffc2dab8ff42b8162f54ddc509676e2
alterNERDtive (Migrated from github.com) requested changes 2022-07-11 13:45:59 +02:00
alterNERDtive (Migrated from github.com) commented 2022-07-11 13:45:45 +02:00

The full line should read

that](configuration/EliteAttack.md#settings).

It’s not a relative link on the site, it’s the path to the Markdown file :)

The full line should read ``` that](configuration/EliteAttack.md#settings). ``` It’s not a relative link on the site, it’s the path to the Markdown file :)
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:49:53 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:49:53 +02:00

I'll get my coat... 9a916d5e78

I'll get my coat... https://github.com/alterNERDtive/VoiceAttack-profiles/pull/149/commits/9a916d5e78b219aead1fa608f15e1a728d523bee
ACyprus (Migrated from github.com) reviewed 2022-07-11 13:59:02 +02:00
ACyprus (Migrated from github.com) commented 2022-07-11 13:59:02 +02:00

ahaaa, I see. In that case, update using similar to the original for first and second lines:

fd5d8ef30b

ahaaa, I see. In that case, update using similar to the original for first and second lines: https://github.com/alterNERDtive/VoiceAttack-profiles/pull/149/commits/fd5d8ef30b8aa0f6f1762b7ccf4294c3437bcafc
alterNERDtive (Migrated from github.com) approved these changes 2022-07-11 14:06:48 +02:00
alterNERDtive commented 2022-07-11 14:06:56 +02:00 (Migrated from github.com)

Top. I’ll go cherry-pick your commits later, first I need food. And then kids are back :)

Top. I’ll go cherry-pick your commits later, first I need food. And then kids are back :)
alterNERDtive commented 2022-07-11 19:49:10 +02:00 (Migrated from github.com)

All cherry-picked into devel. Thanks!

All cherry-picked into `devel`. Thanks!

Pull request closed

Sign in to join this conversation.
No description provided.