<div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sun, Mar 15, 2020 at 11:12 AM Joel Sherrill <<a href="mailto:joel@rtems.org">joel@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div dir="ltr"><br></div><br><div class="gmail_quote"><div dir="ltr" class="gmail_attr">On Sat, Mar 14, 2020 at 10:55 PM Gedare Bloom <<a href="mailto:gedare@rtems.org" target="_blank">gedare@rtems.org</a>> wrote:<br></div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex">On Sat, Mar 14, 2020 at 2:05 PM Joel Sherrill <<a href="mailto:joel@rtems.org" target="_blank">joel@rtems.org</a>> wrote:<br>
><br>
> I put devel@ back on<br>
><br>
> On Sat, Mar 14, 2020, 2:23 PM Mritunjay Sharma <<a href="mailto:mritunjaysharma394@gmail.com" target="_blank">mritunjaysharma394@gmail.com</a>> wrote:<br>
>><br>
>> Hi,<br>
>><br>
>> 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?<br>
><br>
><br>
> I hate to start with use your judgement but...<br>
><br>
> You could just ask on the list for deletion confirmation. My impression is that a deletion pass will be quick.<br>
><br>
> For moving content to rtems-docs, that will be patches which need review. So post those.<br>
><br>
> And I suspect some BSPs will have pages that are useless stubs. Ask about just deleting instead of converting them.<br>
><br>
> Thanks for pitching in.<br>
<br>
I would prefer to have an analysis of the difference between what has<br>
been migrated already<br>
<a href="https://docs.rtems.org/branches/master/user/bsps/index.html" rel="noreferrer" target="_blank">https://docs.rtems.org/branches/master/user/bsps/index.html</a> versus<br>
what is in the wiki. If some content needs to move out of the wiki,<br>
then a patch to add it to the docs would be good, then we could<br>
discuss on the list whether or not to move that content or to delete<br>
it.  If content has been migrated or the migration discussion leads to<br>
a decision to delete, then we should remove that page. Removing a page<br>
requires an admin privilege, so I think a list of pages to be removed<br>
should be maintained somewhere like<br>
<a href="https://devel.rtems.org/wiki/TBR/BSP" rel="noreferrer" target="_blank">https://devel.rtems.org/wiki/TBR/BSP</a></blockquote><div><br></div><div>I have made a sweep to delete all text which has links to non-existent pages</div><div>since those do not have to be reviewed.</div><div><br></div><div>My next pass is to delete all pages for BSPs and ports that have been removed.</div><div>That is a simple review process. </div></div></div></blockquote><div><br></div><div>I have completed this also. </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div><br></div><div>After that, what should be left is a list of pages which need manual review to</div><div>extract/convert useful content to the Users Guide. This should be one patch</div><div>and email per BSP/Wiki page. </div></div></div></blockquote><div><br></div><div>This should be ready to dig into. I suspect that a number of the BSP pages are</div><div>marginal having been written by Google Code-In students. If they just have </div><div>hardware descriptions from vendor pages and no howtos, what do we want to do?</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><div dir="ltr"><div class="gmail_quote"><div><br></div><div>I also found this list:</div><div><br></div><div><a href="https://devel.rtems.org/wiki/TBR/UserManual" target="_blank">https://devel.rtems.org/wiki/TBR/UserManual</a> which has a variety of topic</div><div>pages which need review and either deleted or merged into the appropriate</div><div>documentation.</div><div><br></div><div>--joel</div><div> </div><blockquote class="gmail_quote" style="margin:0px 0px 0px 0.8ex;border-left:1px solid rgb(204,204,204);padding-left:1ex"><br>
<br>
>><br>
>><br>
>> Thanks,<br>
>> Mritunjay<br>
>><br>
>> On Sat, Mar 14, 2020 at 10:30 PM Joel Sherrill <<a href="mailto:joel@rtems.org" target="_blank">joel@rtems.org</a>> wrote:<br>
>>><br>
>>> Hi<br>
>>><br>
>>> 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.<br>
>>><br>
>>> The wiki includes an incomplete and out of date list of BSPs and architectures that have been removed.<br>
>>><br>
>>> Wiki is here: <a href="https://devel.rtems.org/wiki/TBR/Website/Board_Support_Packages" rel="noreferrer" target="_blank">https://devel.rtems.org/wiki/TBR/Website/Board_Support_Packages</a><br>
>>><br>
>>> Users Guide is in the rtems-docs repo and viewable online at <a href="http://docs.rtems.org" rel="noreferrer" target="_blank">docs.rtems.org</a>.<br>
>>><br>
>>> 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.<br>
>>><br>
>>> --joel<br>
>>><br>
>>><br>
>>> _______________________________________________<br>
>>> devel mailing list<br>
>>> <a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
>>> <a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
><br>
> _______________________________________________<br>
> devel mailing list<br>
> <a href="mailto:devel@rtems.org" target="_blank">devel@rtems.org</a><br>
> <a href="http://lists.rtems.org/mailman/listinfo/devel" rel="noreferrer" target="_blank">http://lists.rtems.org/mailman/listinfo/devel</a><br>
</blockquote></div></div>
</blockquote></div></div>