From Fedora Project Wiki
(Quotation marks around application names?) |
mNo edit summary |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 8: | Line 8: | ||
--[[User:Thub|Thub]] 15:08, 27 July 2010 (UTC) | --[[User:Thub|Thub]] 15:08, 27 July 2010 (UTC) | ||
Also, now that I look at it, the Exercise Types section talks about the six broad categories but goes on to list thirteen items, which don't seem very broad. Not having used this program I don't really know what should go here. | |||
--[[User:Thub|Thub]] 16:07, 27 July 2010 (UTC) | |||
As for how to list applications, I've been back and forth all through the writing process. I've since determined a style guide to use, and there will be no quotation marks around application names. As for the 6/13 types of exercises, I didn't notice that, so thank you. | |||
-- [[User:Crantila|Crantila]] 02:08, 28 July 2010 (UTC) | |||
== To Do == | |||
# From the "Requirements" section: spelling mistake in first sentence, "alread" | |||
# From "When you run 'Solfege' for the first time" point #5, maybe you shouldn't directly quote the help file if there are so many grammatical errors in it. Perhaps paraphrasing? | |||
# From Configuration section, under "External Programs" Tab, subsection "Miscellaneous": Reminder to find out what text editor is for! | |||
# From Configuration section, under "Practise": Reminder to find out what "Expert mode" is. | |||
# From Configuration section, under "Sound Setup" 4th point: Capitalize first letter, "The button" not "the button." | |||
# From How to Train Yourself, 3rd paragraph, "recent research has suggested that ..." which source are you quoting? | |||
# From How to Train Yourself, under "Requirements": What else??? | |||
# From How to Train Yourself, under "Exercise Types": Hear Tones (Useless!!!) ... perhaps it is intended to train people to develop perfect pitch? Either way, probably isn't nice of you to say that it's useless ... | |||
# From How to Train Yourself, under "Developing an Aural Skills etc." Segment 2, point #2: Just a suggestion, take away "real" from sentence. "listen to some music." | |||
# From How to Train Yourself, under "Supplementary References": Perhaps add the Rhythm Book. It's where takadimi is taught, I think. | |||
# From How to Train Yourself, under "Supplementary References": Just to be annoying, I'm going to point out that the Hall book also has 3 and 4 part exercises! | |||
# From How to Use Listening Exercises: I don't know if contractions are okay for this style, but I found one under point #2, "it's" | |||
# From How to Use Singing Exercises, under "Sing intervals" point 5: "The exercising is self-policing" ... I'm not sure I understand what you mean. | |||
# From How to Use Singing Exercises, under "Sing chord" point 6: Please finish. | |||
# From How to Use Singing Exercises, under "Sing chord tone" point 4 and 5: from point 4, it tells you to sing, not "it tell you to sing" and point 5, "yadda?" | |||
# From Using "Configure Yourself" Exercises, under "Compare Intervals" point 3: another contraction. | |||
# From Using "Rhythm" Exercises: Not sure I understand what you mean by "I just need to be sure to say to use "Backspace" button when you make a mistake." | |||
# From Using "Rhythm" Exercises, point 2, sub-point 2: ka-di-mi, not "da-di-mi"? | |||
# From Using "Rhythm" Exercises, point 7: Spelling of "time" | |||
# Also, now that I look at it, the Exercise Types section talks about the six broad categories but goes on to list thirteen items, which don't seem very broad. Not having used this program I don't really know what should go here. | |||
[[User:Crantila|Crantila]] 02:14, 28 July 2010 (UTC) | |||
== Further Discussion == | |||
It hasn't generally been my policy to revise things on their way into DocBook, but this article was terrible. It still isn't much better. | |||
[[User:Crantila|Crantila]] 19:26, 29 July 2010 (UTC) | |||
Latest revision as of 19:26, 29 July 2010
Is putting the name of the application in quotes a convention used throughout this guide? It's an unusual use of quotation marks and I don't think it's necessary to highlight the name of the application throughout the document anyway. My main problem with this is that in several places the application name is used in the possessive, which is definitely not a correct use of quotes and it makes it somewhat awkward to read. If you feel the quotes are necessary, may I suggest avoiding the possessive? For instance:
"Solfege"'s exercises are arranged in six broad categories
could be changed to
The exercises in "Solfege" are arranged in six broad categories
--Thub 15:08, 27 July 2010 (UTC)
Also, now that I look at it, the Exercise Types section talks about the six broad categories but goes on to list thirteen items, which don't seem very broad. Not having used this program I don't really know what should go here.
--Thub 16:07, 27 July 2010 (UTC)
As for how to list applications, I've been back and forth all through the writing process. I've since determined a style guide to use, and there will be no quotation marks around application names. As for the 6/13 types of exercises, I didn't notice that, so thank you.
-- Crantila 02:08, 28 July 2010 (UTC)
To Do
- From the "Requirements" section: spelling mistake in first sentence, "alread"
- From "When you run 'Solfege' for the first time" point #5, maybe you shouldn't directly quote the help file if there are so many grammatical errors in it. Perhaps paraphrasing?
- From Configuration section, under "External Programs" Tab, subsection "Miscellaneous": Reminder to find out what text editor is for!
- From Configuration section, under "Practise": Reminder to find out what "Expert mode" is.
- From Configuration section, under "Sound Setup" 4th point: Capitalize first letter, "The button" not "the button."
- From How to Train Yourself, 3rd paragraph, "recent research has suggested that ..." which source are you quoting?
- From How to Train Yourself, under "Requirements": What else???
- From How to Train Yourself, under "Exercise Types": Hear Tones (Useless!!!) ... perhaps it is intended to train people to develop perfect pitch? Either way, probably isn't nice of you to say that it's useless ...
- From How to Train Yourself, under "Developing an Aural Skills etc." Segment 2, point #2: Just a suggestion, take away "real" from sentence. "listen to some music."
- From How to Train Yourself, under "Supplementary References": Perhaps add the Rhythm Book. It's where takadimi is taught, I think.
- From How to Train Yourself, under "Supplementary References": Just to be annoying, I'm going to point out that the Hall book also has 3 and 4 part exercises!
- From How to Use Listening Exercises: I don't know if contractions are okay for this style, but I found one under point #2, "it's"
- From How to Use Singing Exercises, under "Sing intervals" point 5: "The exercising is self-policing" ... I'm not sure I understand what you mean.
- From How to Use Singing Exercises, under "Sing chord" point 6: Please finish.
- From How to Use Singing Exercises, under "Sing chord tone" point 4 and 5: from point 4, it tells you to sing, not "it tell you to sing" and point 5, "yadda?"
- From Using "Configure Yourself" Exercises, under "Compare Intervals" point 3: another contraction.
- From Using "Rhythm" Exercises: Not sure I understand what you mean by "I just need to be sure to say to use "Backspace" button when you make a mistake."
- From Using "Rhythm" Exercises, point 2, sub-point 2: ka-di-mi, not "da-di-mi"?
- From Using "Rhythm" Exercises, point 7: Spelling of "time"
- Also, now that I look at it, the Exercise Types section talks about the six broad categories but goes on to list thirteen items, which don't seem very broad. Not having used this program I don't really know what should go here.
Crantila 02:14, 28 July 2010 (UTC)
Further Discussion
It hasn't generally been my policy to revise things on their way into DocBook, but this article was terrible. It still isn't much better.
Crantila 19:26, 29 July 2010 (UTC)