BSP Wiki Clean Up

Gedare Bloom gedare at rtems.org
Sun Mar 15 03:55:29 UTC 2020


On Sat, Mar 14, 2020 at 2:05 PM Joel Sherrill <joel at rtems.org> wrote:
>
> I put devel@ back on
>
> On Sat, Mar 14, 2020, 2:23 PM Mritunjay Sharma <mritunjaysharma394 at gmail.com> wrote:
>>
>> Hi,
>>
>> I am very much willing to help with this thing. Being a bit new to the community, I just wanted to know that while deleting the wiki content on obsolete BSPs, do I need to report it before deleting and create a ticket for it or I can straightaway delete it?
>
>
> I hate to start with use your judgement but...
>
> You could just ask on the list for deletion confirmation. My impression is that a deletion pass will be quick.
>
> For moving content to rtems-docs, that will be patches which need review. So post those.
>
> And I suspect some BSPs will have pages that are useless stubs. Ask about just deleting instead of converting them.
>
> Thanks for pitching in.

I would prefer to have an analysis of the difference between what has
been migrated already
https://docs.rtems.org/branches/master/user/bsps/index.html versus
what is in the wiki. If some content needs to move out of the wiki,
then a patch to add it to the docs would be good, then we could
discuss on the list whether or not to move that content or to delete
it.  If content has been migrated or the migration discussion leads to
a decision to delete, then we should remove that page. Removing a page
requires an admin privilege, so I think a list of pages to be removed
should be maintained somewhere like
https://devel.rtems.org/wiki/TBR/BSP

>>
>>
>> Thanks,
>> Mritunjay
>>
>> On Sat, Mar 14, 2020 at 10:30 PM Joel Sherrill <joel at rtems.org> wrote:
>>>
>>> Hi
>>>
>>> GSoC students and those who are unfortunately self-quarrantined looking for something to do could really help by reviewing the wiki BSP pages and helping move the current content to the Users Guide.
>>>
>>> The wiki includes an incomplete and out of date list of BSPs and architectures that have been removed.
>>>
>>> Wiki is here: https://devel.rtems.org/wiki/TBR/Website/Board_Support_Packages
>>>
>>> Users Guide is in the rtems-docs repo and viewable online at docs.rtems.org.
>>>
>>> I think much of the effort is quite straight forward. First pass is to delete wiki content that is on obsolete bsps and architectures. Delete bullets with links to no-existent pages. Introduction text on top page is likely useful to merge. Then remaining BSPs which are in the tree and have pages need the content reviewed and merged into users guide.
>>>
>>> --joel
>>>
>>>
>>> _______________________________________________
>>> devel mailing list
>>> devel at rtems.org
>>> http://lists.rtems.org/mailman/listinfo/devel
>
> _______________________________________________
> devel mailing list
> devel at rtems.org
> http://lists.rtems.org/mailman/listinfo/devel


More information about the devel mailing list