Skip to content
Open
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 3 additions & 3 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,13 +4,13 @@ This git repo contains the manual for Audacity
## Flow of Content

* We write the Audacity Manual at https://alphamanual.audacityteam.org
* We wget it and mangle it a little using our script, https://github.com/audacity/audacity/blob/master/scripts/mw2html_audacity/mw2html.py
* We get it and mangle it a little using our script, https://github.com/audacity/audacity/blob/master/scripts/mw2html_audacity/mw2html.py
Copy link

Choose a reason for hiding this comment

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

[Nitpick/Proofreading/Question] I’m having trouble understanding what “mangle” means @Rajeta-Sarkar. Does it mean fix?

Suggested change
* We get it and mangle it a little using our script, https://github.com/audacity/audacity/blob/master/scripts/mw2html_audacity/mw2html.py
* We get it and mangle it a little using our script, https://github.com/audacity/audacity/blob/master/scripts/mw2html_audacity/mw2html.py

Copy link
Member

Choose a reason for hiding this comment

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

"wget" refers to: https://www.gnu.org/software/wget/

"Mangled" means that it is pulled around / modified. In British English the term is used, slightly humorously, to describe something being reshaped in an inelegant manner.

* That content is then pushed as a commit to the GitHub repo.
* A script on our server detects the change at GitHub and pulls the changes to serve them.

## Wiki Tricks

There is a lot of content in our manual which would be prohibitively time consuming to produce without automated tools to help us. This is particularly so of the many image maps in the manual.
There is a lot of content in our manual which would be prohibitively time consuming to produce without automated tools to help us. This is particularly so of the many image maps in the manual.

* Most of our tricks are documented at https://wiki.audacityteam.org/wiki/Magicke_Spells
Copy link

Choose a reason for hiding this comment

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

[Nitpick/proofreading] see line 16 for context.

Suggested change
* Most of our tricks are documented at https://wiki.audacityteam.org/wiki/Magicke_Spells
* Most of our tricks are documented at https://wiki.audacityteam.org/wiki/Magicke_Spells

* The heavy lifting is done by our 'What Is That' page https://wiki.audacityteam.org/wiki/Using_WIT
* The heavy lifting is done by our 'What Is That' page https://wiki.audacityteam.org/wiki/Using_WIT
Copy link

Choose a reason for hiding this comment

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

[Nitpick/Proofreading] I think hyperlinking the page’s title would make it quicker for users to access the content. Consider doing that for line 15.

Suggested change
* The heavy lifting is done by our 'What Is That' page https://wiki.audacityteam.org/wiki/Using_WIT
* The heavy lifting is done by our [What Is That page](https://wiki.audacityteam.org/wiki/Using_WIT)