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/415 move docu from wiki to docs #472

Open
wants to merge 6 commits into
base: develop
Choose a base branch
from

Conversation

krHERO
Copy link
Member

@krHERO krHERO commented Nov 15, 2024

Description, Context and related Issue

I moved the content (technical documentation) from the wiki to edirom-online/docs. The community agreed, the place does not fit best for the technical documentation and it is not under version control. A very good plus by cleaning the wiki while moving its content to a more suitable place is that we can capture the information regarding edirom community at the wiki now. I plan to delete the content of the wiki after this PR is reviewed and merged.

four files were created in edirom-online/docs

  • docs/customize.md, information from different subtopics of the old wiki-content were collected in this one file (created by @riedde and @nikobeer , still valid)
  • docs/old-deprecated-documentation-from-wiki.md, copy/paste the old sections without updates (created by @nikobeer and @bwbohl , deprecated, should be removed in releases after v1.0.0)
  • docs/release-workflow.md, was moved from the wiki (still valid, created 2022 by @riedde )
  • docs/setup.md, was added initially (created at ESS2024 by @feuerbart )

Refs #415

How Has This Been Tested?

I did a self-review of the text.

Types of changes

  • Documentation Update
  • Improvement

Overview

we want to move all information regarding (technical) documentation to edirom-online/docs from the wiki. description of release workflow is a part of this.

Refs #Edirom#415
we want to move all information regarding (technical) documentation to edirom-online/docs from the wiki. description of customization is a part of this. The content was taken from several places in the wiki and integrated to a newly introduced structure of this file.

Refs Edirom#415
since the file has several topics and subtopics this commit adds a table of content.

Refs Edirom#415
this commit adds a detailed setup description for Edirom-Online and a data package. It is more detailed than in the readme.md to make every step as clear as possible, since the readme.md instructions are fine for advanced developers that need only a short and quick description. 
thanks to @feuerbart for capturing this during the edirom-summer-school 2024. i corrected only some minor typos and changed only a little bit regarding the structure.

Refs Edirom#415
…ine/docs

to have this information captured once before it will be updated by future releases, it will be saved with this commit. The documentation was written 2015–2017.

Refs Edirom#415
@krHERO krHERO added this to the 1.0.0 milestone Nov 15, 2024
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
Status: In Progress
Development

Successfully merging this pull request may close these issues.

1 participant