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

Ftr/471 enhance update help page #497

Merged
merged 8 commits into from
Dec 11, 2024

Conversation

krHERO
Copy link
Member

@krHERO krHERO commented Dec 10, 2024

Description, Context and related Issue

the help files were more than 10 years un-touched, so some deprecated information had to be deleted, eg installation advices for DVD. the file had a lot of comments, that were resolved. the file had some duplicate texts (even repeating one image), so a lot clean up had to be made. also a lot restructuring needed to be done, since text, a topic was started and linked to the explanation several (sub)chapters away, so all parts that belong together were put together now.
some too long (and too detailed) explanations needed to be simplified/shortened.

refs #471 #28

How Has This Been Tested?

proof-red the german and english help file with sample edition and klarinettenquintett.

Types of changes

  • Documentation Update
  • Improvement

Overview

  • I have updated the inline documentation accordingly.
  • I have performed a self-review of my code, according to the style guide
  • I have read the CONTRIBUTING document.

roewenstrunk and others added 6 commits December 2, 2024 15:47
this commit updates the metadata, eg add orcid IDs, update link, delete outdated addresses

Refs #471
this commit updated the <front> text with some simplifications of sentences. Preparation chapter is deleted, because of two reasons. first, it is totally outdated and describes how to install the software from a DVD. Second, how to setup an Edirom locally is described in the docs-directory of the software-repository, the USER help is not an appropriate place for this.

refs #471
this commits does a lot of clean up: delete deprecated content (eg installation from DVD), sum up text, delete duplicate text, re-structure, shorten and simplify sentences, move comments to appropriate issues

refs #471
this commit corrects some typos and structure

refs #471
this commits completely updated the help using the german help-file as a template.

refs #471
@daniel-jettka
Copy link
Contributor

It seems like language keys are not resolved in figure texts. And @krHERO Do you see the images?

image

@krHERO
Copy link
Member Author

krHERO commented Dec 11, 2024

hi @daniel-jettka and thanks for taking care about this PR. yes i can see the images. @roewenstrunk found out, that exist seems to "forget" the images locally. so after adding them again to the images folder via exide: file - manage - navigate to images folder and "upload-cloud". after this, you can see the images locally. with loading images also the language keys are resolved.

Bildschirmfoto 2024-12-11 um 13 15 28

Copy link
Contributor

@daniel-jettka daniel-jettka left a comment

Choose a reason for hiding this comment

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

I generally approve.

There is just an issue with nested language keys (extra whitespace), but I will create another issue for this... #499

image

@daniel-jettka daniel-jettka merged commit 01aa130 into develop Dec 11, 2024
5 checks passed
@daniel-jettka daniel-jettka deleted the ftr/471-enhance-update-help-page branch December 11, 2024 16:03
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: Done
Development

Successfully merging this pull request may close these issues.

3 participants