Skip to content

OSRB documentation review#68

Merged
scetron merged 71 commits into
developfrom
docs-review
Aug 31, 2022
Merged

OSRB documentation review#68
scetron merged 71 commits into
developfrom
docs-review

Conversation

@progala

@progala progala commented Jul 21, 2022

Copy link
Copy Markdown
Contributor

First pass of the documentation review.

General comments:

  • We should think about breaking the readme into multiple documents. This should help us with structuring it better as well.
  • I've reworded some of the sections and added questions and suggestions on lines starting with | Przemek:
  • We should involve Dwight in the process to help with reviewing language and grammar.

Comment thread README.md Outdated
Comment thread README.md Outdated
@lvrfrc87

Copy link
Copy Markdown
Collaborator

@progala Can we have your opinion on Christian comments so I can do the required changes?
Thanks a lot.

@scetron scetron left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

@progala @chadell @jeffkala I've made a good number of updates to the Readme. Some of these sections will become parts of the expanded doc, but I wanted to get your take on them for now. Please have a look at the changes and leave any comments.

scetron
scetron previously approved these changes Aug 1, 2022
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md Outdated
Comment thread README.md
Comment thread README.md Outdated
Comment thread docs/architecture.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/usage.md Outdated
Comment thread docs/index.md Outdated
@progala

progala commented Aug 26, 2022

Copy link
Copy Markdown
Contributor Author

@lvrfrc87 @scetron Thanks for making the changes! We're good to merge.

@jeffkala jeffkala left a comment

Copy link
Copy Markdown
Collaborator

Choose a reason for hiding this comment

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

Also looks like a few of the diagrams/PNG files still reference NETCOMPARE insetad of JDIFF.

Comment thread docs/architecture.md Outdated
Comment thread docs/index.md
@scetron
scetron merged commit f70f683 into develop Aug 31, 2022
@lvrfrc87
lvrfrc87 deleted the docs-review branch September 26, 2022 13:33
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.

6 participants