Conversation
|
In general, I would place the references later in the sentences/paragraph. To not break that much the text flow. Some examples. I would do: "Agama 19 represents a quite significant architectural overhaul, needed to leave all those quirks behind and to define mechanisms that can be the cornerstone for any future development (see #2951 and #2998)." Instead of: "Agama 19 represents a quite significant architectural overhaul (see #2951 and #2998), needed to leave all those quirks behind and to define mechanisms that can be the cornerstone for any future development.". I would do: "the new navigation experience, based on a better overview page and a more useful confirmation dialog, sets the direction to follow (see #2988, #3009 and #3025).". Instead of: "the new navigation experience, based on a better overview page and a more useful confirmation dialog (see #2988, #3009 and #3025), sets the direction to follow.". I would do: "now the user interface dynamically reacts to changes in the underlying system. For instance, when a new cable is plugged in or when a new WiFi adapter is connected (see #3285).". Instead of: "now the user interface dynamically reacts to changes in the underlying system (see #3285). For instance, when a new cable is plugged in or when a new WiFi adapter is connected.". And so on. |
|
Good point, but I have to go right now, I will do it in a few hours |
blog/2026-03-20-agama-19.mdx
Outdated
| step to turn the web interface into a useful learning and prototyping tool for more advanced | ||
| scenarios, although this new functionality could benefit from several usability improvements. Stay | ||
| tuned. | ||
| The web user interface also got a new option to [download](https://github.com/agama-project/agama/pull/3256) |
There was a problem hiding this comment.
NP: I would turn the whole "new option to download" into the link.
blog/2026-03-20-agama-19.mdx
Outdated
| But Agama 19 does not only bring restructuring and rewrites, it also comes with a bunch of new | ||
| functionality, like the new ability to install some distributions in different so-called | ||
| installation modes. | ||
| installation modes (see [#3086](https://github.com/agama-project/agama/pull/3086)). |
There was a problem hiding this comment.
Instead of adding "see #3086" I would turn "installation modes" into the link.
blog/2026-03-20-agama-19.mdx
Outdated
| When installing the experimental pre-releases of SLES 16.1 or the corresponding version of SLES for | ||
| SAP Applications, now it is possible to select between the Standard and the Immutable modes. See the | ||
| following screenshot for details. | ||
| SAP Applications (see [#3146](https://github.com/agama-project/agama/pull/3146)), now it is possible |
There was a problem hiding this comment.
I don't think this link is much relevant. The important one is the previous (#3086) that adds the functionality.
|
|
||
| As you can see, Agama 19 is quite a significant release. But there is room for many things in four | ||
| months, even to work beyond Agama itself. During this time we also incorporated several changes to | ||
| the live ISO that most of you use to execute Agama. |
There was a problem hiding this comment.
NP: I would not put the link in this first paragraph (that is kind of an introduction) but in the next one that lists the concrete changes.
Having said so, it is true this section is based on agama-project/agama#3210 and agama-project/agama#2923. But also on agama-project/agama#3185, which was not referenced.
- moved them to end of sentence - when suitable, link with topic, not PR number - removed a too specific PR link about SLE-SAP
|
@ancorgs thanks for your suggestions, applied. Thanks for bearing with my not so smart LLM usage :-/ |
2 participants
Produced by Gemini, but all links clicked and verified to be relevant by myself.