#3831 closed defect (fixed)
Duplicate description of Tiers and Rules
Reported by: | Joel Sherrill | Owned by: | Chris Johns |
---|---|---|---|
Priority: | normal | Milestone: | 5.1 |
Component: | doc | Version: | 5 |
Severity: | normal | Keywords: | |
Cc: | Blocked By: | ||
Blocking: |
Description
I think https://docs.rtems.org/branches/master/user/hardware/tiers.html is intended to be the real site of this information. However, https://devel.rtems.org/wiki/Developer/Architectures also describes the tiers rules with slightly different language.
I think the Wiki page can be reviewed and removed. But any references and sub-pages should be dealt with at the same time. https://devel.rtems.org/search?q=Developer%2FArchitectures&noquickjump=1&wiki=on shows two sub-pages to deal with:
- https://devel.rtems.org/wiki/Developer/Architectures/ARM which is one sentence and can be removed.
- https://devel.rtems.org/wiki/Developer/Architectures/ARM/ARM-EABI which probably should move to the Users Manual.
This would eliminate a few pages and a point of duplication for a very important concept to the RTEMS Project.
Change History (6)
comment:1 Changed on 12/04/19 at 13:26:37 by Sebastian Huber
comment:2 Changed on 12/04/19 at 13:28:09 by Joel Sherrill
Thanks. I tripped across this doing the FSW slides. Were there links to these pages?
comment:3 Changed on 12/04/19 at 13:31:34 by Sebastian Huber
How can we figure out if there are links?
The Developer/Architectures? looks like content which should be synchronized with the user manual and then get deleted.
comment:4 Changed on 12/05/19 at 14:34:51 by Christian Mauderer
I would interpret the two sources slightly different:
- The manual (at docs.rtems.org) sounds like tires are a per commit property. That would mean that every published result tells "The BSP has this Tire on commit/release xyz". That seems like a sane approach.
- The wiki on the other hand tells something about "all commits". That's a quite inaccurate description. It doesn't tell what the first commit is. So in theory every commit since RTEMS exists has to build and work for that board. That is just is impossible. Beneath that the wiki allows simulator results in tire 1. So it's not entirely clear what the difference to tire 2 is.
I would vote for dropping the inaccurate description in the wiki in favor of the more accurate one in the manual.
comment:5 Changed on 12/12/19 at 17:00:11 by Joel Sherrill <joel@…>
Resolution: | → fixed |
---|---|
Status: | assigned → closed |
In [changeset:"01be51383f39afb3803a05f4bbcce5d91737b06e/rtems-docs" 01be513/rtems-docs]:
comment:6 Changed on 12/12/19 at 17:29:08 by Joel Sherrill
Wiki page deleted.
Sebastian: I searched for the Wiki page name in only wiki pages. Maybe there is another way but that confirmed it had no refernces.
I removed both ARM pages. The information was out of date since a couple of years.