Wiki editing discussion

Page 22/38
15 | 16 | 17 | 18 | 19 | 20 | 21 | | 23 | 24 | 25 | 26 | 27

By gdx

Prophet (2656)

gdx's picture

23-08-2018, 09:53

I agree it is difficult to read in yellow on gray and with each name preceded by "Category:".

Reflecting on CALL TEMPER, this is not a instruction to change the rhythm so Pure Rhythm and Perfect Rhythm are probably a bad translation.

By Manuel

Ascended (15288)

Manuel's picture

23-08-2018, 21:21

gdx wrote:
Manuel wrote:

I suggest to just write CALL everywhere, remove the 'abbreviated' columns everywhere and at the wiki article of CALL explain that it can be abbreviated into _.

I already suggested it but mars did not want. I also think it is enough to say once in the description of CALL or at most put a remark under the table.

To me, the rationale that mars2000you gave is not very clear. Can you clarify, mars? Why repeat things so extensively? It adds so much unnecessary fuss to an article.

By mars2000you

Enlighted (5467)

mars2000you's picture

23-08-2018, 22:51

(21h35) There is here an interesting remark:

Quote:

or at most put a remark under the table.

It's possible to do that, but because some tables are very long (more than 20 instructions, there are extensions with 70 instructions!), the remark and link to the 'general' CALL page need to be before the table, not under! if we remove the extra column, it's the only way to be sure that the curious user will take a look at the 'general' CALL page that is actually for advanced programmers, not for beginners in programming or simple end-users (and that's the repetition of my main argument).

However, there is a BASIC extension for which I would keep the extra column, it's Network BASIC, because it's better to keep the 3 variants for most of the instructions. (Just take a look at the page to visually understand !)

Edit - 21h 45 -Just started this change. The tables will be preceeded by this text:

Note: CALL can be replaced by the character underscore (_). A space is not required after this character. See [[CALL]] for more info.

Edit2 - 22h44 - Just finished the change (with something different for Network BASIC page!)

By Manuel

Ascended (15288)

Manuel's picture

23-08-2018, 23:48

Thanks!
You could also link to https://www.msx.org/wiki/CALL#Syntax, which contains that exact text.

By mars2000you

Enlighted (5467)

mars2000you's picture

23-08-2018, 23:55

I prefer to iink to the complete page, not just a part. That's the meaning of "more info'.

As already said, not everyone will go this page, so the note needs to be on all extensions pages including instructions using CALL.

And the people who will go to this page will be mainly advanced programmers, so it's not only the syntax that will interest them!

By T.R.

Rookie (22)

T.R.'s picture

24-08-2018, 02:23

Just chiming in here as an outsider so I hope I'm not offending anyone. But what's the point of having a wiki page for *each* call statement of *each* BASIC extension in existence? Really looks like overkill to me. A wiki is not supposed to be a user guide. Besides, many of this stuff seems very obscure. Instead of being actually useful it could confuse newcomers.

By gdx

Prophet (2656)

gdx's picture

11-11-2018, 08:41

I created a wiki page for beginners in assembler.

http://www.msx.org/wiki/Assembler_for_Dummies_%28Z80%29

I hope it will help someone. I invite experts to change what is wrong and add what would be lacking. Critics are welcome.

By Manuel

Ascended (15288)

Manuel's picture

11-11-2018, 10:56

Looks like a great start!
What always puzzles me a bit are the somewhat more advanced assembler-specific instructions like PHASE. And it's good to also mention other assembler things like INCBIN, etc. But these may already a bit too advanced for that article.
An assembly programmer mostly needs to know how to program the other chips, like VDP. I guess that's the hardest part.

By luppie

Paladin (854)

luppie's picture

11-11-2018, 11:27

Manuel wrote:

Looks like a great start!

I agree.
But what I'm missing as a totally beginner is a 'Hello World' example with explanation to get an impression.

By gdx

Prophet (2656)

gdx's picture

11-11-2018, 11:52

luppie wrote:

What always puzzles me a bit are the somewhat more advanced assembler-specific instructions like PHASE. And it's good to also mention other assembler things like INCBIN, etc. But these may already a bit too advanced for that article.

In addition advanced statements are almost always different on each assembler. It's better to know the basics and a suitable assembler before trying to use them.

luppie wrote:

what I'm missing as a totally beginner is a 'Hello World' example with explanation to get an impression.

Good idea. That and some other relevant examples would help.

Page 22/38
15 | 16 | 17 | 18 | 19 | 20 | 21 | | 23 | 24 | 25 | 26 | 27
My MSX profile