Skip to content

Commit

Permalink
Smaller first changes
Browse files Browse the repository at this point in the history
  • Loading branch information
bratpeki committed Mar 24, 2024
1 parent b2c7faa commit 166001e
Show file tree
Hide file tree
Showing 4 changed files with 17 additions and 13 deletions.
3 changes: 3 additions & 0 deletions .gitignore
Original file line number Diff line number Diff line change
@@ -0,0 +1,3 @@
# Any and all HTML and PDF files should be left out of the Git index
*.html
*.pdf
2 changes: 1 addition & 1 deletion Glossary.adoc
Original file line number Diff line number Diff line change
Expand Up @@ -2,4 +2,4 @@
// We need to figure out a way to sort the items here alphabetically
// https://github.com/zynaddsubfx/user-manual/issues/6

NOTE: Here by glossary!
NOTE: Here by glossary!
7 changes: 4 additions & 3 deletions Goals.adoc
Original file line number Diff line number Diff line change
@@ -1,5 +1,7 @@
=== Goals of this User Manual
If we want to create a decent user manual, we need t understand why is it needed, who is going to use it and what do they expect. Let's first try to see who and why would want to read the user manual and what would they need to be satisfied with their experience.

If we want to create a decent user manual, we need to understand why is it needed, who is going to use it and what do they expect. Let's first try to see who and why would want to read the user manual and what would they need to be satisfied with their experience.

## Who will read it - and what for?

* Potential new experienced users - to determine if Zyn-Fusion is the right tool for them, to see the limitations and possibilities of Zyn-Fusion - to see if it's worth dedicating time and money to integrate it in their workflow,
Expand Down Expand Up @@ -49,7 +51,6 @@ $ import -window "ZynAddSubFX 3.0.3" Zyn.png
$ display Zyn.png
--------------------------------------------------------------------------------


As long as the default Zyn-Fusion window size (or proportions are not going to change we can simply run `zynaddsubfx` to prepare a screenshot.

If this is subject to change we could override the window size with another command.
Expand Down Expand Up @@ -84,5 +85,5 @@ The only thing that changes is the subdirectory name and file contents. Thus ref
<img src="screenshots/addsynth_global_01/D.png">
<img src="screenshots/formant_filter_main_01/D.png">
--------------------------------------------------------------------------------

The standard _A B C D_ names might be changed if something else proves to be more convenient. They key is to keep this consistent after a scheme is picked, or the system will break, will require tons of manual labor and we will gain nothing.
18 changes: 9 additions & 9 deletions README.md
Original file line number Diff line number Diff line change
@@ -1,25 +1,26 @@
# Zyn-Fusion User Manual
User manual (this may or may not get merged into zynaddsubfx/zynaddsubfx's doc dir)

This repository contains the user manual for Zyn-Fusion (ZynAddSubFX).

This may or may not get merged into zynaddsubfx/zynaddsubfx's doc dir.

## Tools of the trade

The Manual is in `AsciiDoc` format https://powerman.name/doc/asciidoc
The Manual is in [`AsciiDoc` format](https://powerman.name/doc/asciidoc).

For a powerful editor with live preview for Linux, check `AsciidocFX` https://github.com/asciidocfx/AsciidocFX
For a powerful editor with live preview for Linux, check [`AsciidocFX`](https://github.com/asciidocfx/AsciidocFX).

If you need a different tool, look here: https://asciidoctor.org/docs/editing-asciidoc-with-live-preview/
If you need a different tool, look [here](https://asciidoctor.org/docs/editing-asciidoc-with-live-preview/).

## Files

`Manual.adoc` is the main document, which uses `include` statements to pull chapters from individual files.
[`Manual.adoc`](./Manual.adoc) is the main document, which uses `include` statements to pull chapters from individual files.

`Goals.adoc` is a document for the manual writers, to define a coherent idea of what the Manual should be like.
[`Goals.adoc`](./Goals.adoc) is a document for the manual writers, to define a coherent idea of what the Manual should be like.

## How to contribute?

If you'd like to share your knowledge about ZynAddSubFX and help fill in the gaps of this User Manual - first take a look at the Manual.adoc file and read.
If you'd like to share your knowledge about ZynAddSubFX and help fill in the gaps of this User Manual - first take a look at the `Manual.adoc` file and read.

When you'll find something that you feel comfortable writing about, find the appropriate `.adoc` chapter file and contribute there.

Expand All @@ -31,7 +32,7 @@ Every line starting with `//` is regarded as a comment.
Multi-line text enclosed between lines containing only `////` is regarded as a comment to.

// example one line comment

////
example
multi-line
Expand All @@ -43,4 +44,3 @@ If you have any questions, or suggestions - feel free to create an Issue, and li
// Here goes all the term definitions the user might need to reference while reading the manual.
// We need to figure out a way to sort the items here alphabetically
// https://github.com/zynaddsubfx/user-manual/issues/6

0 comments on commit 166001e

Please sign in to comment.