Talk:Programming Conventions

From RISC OS

(Difference between revisions)
Jump to: navigation, search
(Tidy up attributions and note signing command)
(Style)
Line 25: Line 25:
As I said, only minor, in the most part it looks very useful :)
As I said, only minor, in the most part it looks very useful :)
[[User:Polas|Polas]]
[[User:Polas|Polas]]
 +
 +
== Style ==
 +
 +
 +
The style of the article needs to be much more formal. To be suitable as something which has consensus agreement, it needs to avoid first and third person references and casual language.  The PRMs et al of course serve as a good model for this.  It also needs to as much as possible provide references - for example to style guide pages or other material posted on usenet, etc, etc.

Revision as of 19:12, 20 January 2007

When adding comments please sign them with ~~~~ which inserts your username and the date

Comments

Please use the preview button to show how things look, instead of endless change log entries. Pnaulls

Sorry, yes, I've been in the process of translating the page from HTML so keep noticing things and making amendments. Hopefully the basic structure/layout/conversion is complete now. --Adamr 15:03, 8 Jan 2007 (GMT)


Re, Pnaulls' comment:

The following is opinion of Adam Richardson and may
or may not be agreed with by other RISC OS programmers.

I do not intend this page to simply be "my" view of the world. If that were the intention I would have left it on my website. I would rather that it gives a consensus view (if that's possible).

When I first published the article on my website I asked for comments on comp.sys.acorn.programmer and no major issues were raised. The only thing approaching being controversial was the bit about placing modules inside !System.

Peter, are there any specific parts of the document you think ought to be changed/removed?

--Adamr 17:10, 8 Jan 2007 (GMT)

Looks good

In the most part it looks very good and im sure will prove to be very useful. One minor point which I've thought of which might or might not help you - some of the language seems to be a bit informal. There seem to be plenty of people out there who will take a technical document such as this more seriously if the language is formal. For example, the statement "Since, well, ages ago" and the title "Installing Things" (things isnt very technical.)

As I said, only minor, in the most part it looks very useful :) Polas

Style

The style of the article needs to be much more formal. To be suitable as something which has consensus agreement, it needs to avoid first and third person references and casual language. The PRMs et al of course serve as a good model for this. It also needs to as much as possible provide references - for example to style guide pages or other material posted on usenet, etc, etc.

Personal tools