Talk:Ada Programming/Attributes/'Position

@ManuelGR: Hi, Manuel, I've got a problem with the book's Ada Programming structure. While the basic structure is OK, there are some pages with duplication that could be improved.

I was looking for representation clauses and didn't find them in the types chapter about records. I found them in the page for keywords about kw for and again about kw use. A senseless duplication.

There are further examples like attributes Compose and Fraction, which should be dealed together in one page.

Similarly, the attributes Position, First_Bit and Last_Bit should be handled together. (Currently, only the page for Position exists.) These three are now dealt with (my improved contribution) in the page about kw use (not the optimal place).

So for the time being, I would propose:

  • Delete page attribute Position; replace the link by the one to kw use.
  • Delete one of the pages Compose and Fraction; treat them together on the remaining page and link them both to the same page.

I guess there are some more such duplications.

I would do the text improvements, but do not know how to delete pages (there would perhaps remain unresolved links.

Christoph CKWG - Ada Magica (discusscontribs) 11:48, 4 February 2022 (UTC)

Hi, @CKWG - Ada Magica, in my opinion, and I think that were the initial intention of the keyword pages, they should only contain a phrase for each of the contexts where they are used, and a link to the appropriate content page where that topic is explained in detail. That should avoid the duplication. The same could be said for attributes, unless in some cases, where they could be considered the "topic" page, when they have a very specific and isolated usage. So I agree with the "refactoring" you are proposing. In any case, no deletion is required. Everything should be resolved using page moves and redirections, so any authorship and content evolution is preserved in the page histories. -- ManuelGR (discusscontribs) 18:30, 4 February 2022 (UTC)
P.S. See also Help:Pages#Merging ManuelGR (discusscontribs) 18:36, 4 February 2022 (UTC)

@ManuelGR: Links to the Ada Reference Manual still use the outdated 2005 generation. There has been the 2012 generation around for now ten years. And Ada 2022 is on the doorstep.

It's high time the reference were updated to 2012 (and to 2022 as soon as this is officially accepted by ISO) - but I do not know where to find the templates.

CKWG - Ada Magica (discusscontribs) 10:55, 7 February 2022 (UTC)

@CKWG - Ada Magica: I agree. The most productive years in the writing were before 2012 and that is still visible in the current contents. At the end of the first page, there's a link to the "Contributing" page, namely: Wikibooks:WikiProject_Ada. This might be the information you are seeking. There are links to the templates and information on how to use them. Let me know if something is still not clear. ManuelGR (discusscontribs) 16:40, 12 February 2022 (UTC)
How do I write curly braces without their special meaning? In the following, I replace them by parentheses.
There is a mistake on Template:Ada/RM/doc: I claims ((Ada/RM|C|3|2)) gives a link to Ada 2012 with text C.3.2: The Package Interrupts. That's incorrect, it simply gives the text C.3.2. Hu? How come?
So I tried in page Ada Programming/Attributes/'Machine Radix to replace the old reference to 2005 by writing
((Ada/RM|K|Language-Defined Aspects and Attributes))
This astonishingly results in the text
Aspects and Atributes.html K. Language-Defined Aspects and Attributes
with unresolvable link. I give up. Too many obstacles.
The two other links to 5.3 are complete junk.
(I hope wiki does not produce garbage of this text by interpreting some characters as special. CKWG - Ada Magica (discusscontribs) 18:37, 13 February 2022 (UTC)
The documentation was not correctly written to display the title parameter. Previously, there were a lot of templates, because a different one was needed for each chapter depth, but now they are overloaded, and as a consequence, the title parameter has to be named. You can see now how it can be used in Template:Ada/RM, and an example of an update from the old version templates in this edit. Regarding how to escape wiki syntax, you can use the nowiki tag, for example: <nowiki>{{Ada/RM|K|title=Language-Defined Aspects and Attributes}}</nowiki> ManuelGR (discusscontribs) 20:13, 13 February 2022 (UTC)