[Replicant] Wiki revamp: tree-like structure, duplicates, outdated and deprecated

Fil Lupin fillupin at protonmail.com
Wed Aug 21 14:41:59 UTC 2019


Hi David,
great work of refactoring the wiki.
I accepted to gather the suggestion and... I miss time, so thank you. :)

Here are a few remarks about your questions/suggestions:
1. I agree deleting "Replicant" prefix which is redundont
2. about pages https://redmine.replicant.us/projects/replicant/wiki/RecoveryInstallationWithHeimdall and https://redmine.replicant.us/projects/replicant/wiki/ReplicantInstallationHeimdall I am not sure what you mean but they do not seem duplicated to me since the 1st one explain how to install recovery and the 2d one to install replicant
Am I wrong?

For some pages, it probably means stopping support for v4.2, which makes sense but probably should be done by creating a page to help updating from 4.2 to 6 and then 9 (included app & app data).
Is that what you meant?


- Fil Lupin.

‐‐‐‐‐‐‐ Original Message ‐‐‐‐‐‐‐
On Tuesday, August 20, 2019 8:20 PM, dllud <dllud at riseup.net> wrote:

> Hi everybody,
>
> (While waiting for a full Replicant 9 build, and) since I'll have to
> document lots of stuff in the wiki, I decided to give it a review in
> terms of structure.
>
> What I did was:
>
> 1.  Organize pages into a tree-like structure according to themes:
>     https://redmine.replicant.us/projects/replicant/wiki/index
>
> 2.  Harmonize page names (i.e., CamelCase on all).
>
>     Hopefully these changes won't break a thing. Redmine seems to keep track
>     of all name changes, and the parent-child relations are mostly
>     transparent to readers (they seem targeted to editors).
>
>     While at it, I found a few instances of the typical issue that arises
>     when information lacks proper structure: duplication. Here's an example:
>
>
> -
>
> https://redmine.replicant.us/projects/replicant/wiki/RecoveryInstallationWithHeimdall
>
> --------------------------------------------------------------------------------------
>
> https://redmine.replicant.us/projects/replicant/wiki/ReplicantInstallationHeimdall
>
> Here are a few further things that I could do, but didn't, as it's
> better to wait for comments:
>
> 1.  Remove the "Replicant" prefix from the name of several pages
>     (ReplicantArtwork, ReplicantImages, ReplicantInfrastructure,
>     ReplicantInstallation, ReplicantReleaseKey, etc.). I feel that this is
>     quite redundant. Most pages on the wiki are about Replicant, and several
>     do not have the "Replicant" prefix on their name already. IMO removing
>     this prefix would improve the browsing experience throughout the wiki.
>
> 2.  Delete the deprecated pages that followed Wolfgang's update procedure
>     from 4.2 to 6.0:
>     https://redmine.replicant.us/projects/replicant/wiki/DeprecatedReplicant60Pages
>     All the history is already kept on the pages that are now live.
>
>     Thoughts on this?
>
>     Several pages are still in need of an update from Replicant 4.2 to 6.0:
>
>
> -   https://redmine.replicant.us/projects/replicant/wiki/ReplicantSDK
> -   https://redmine.replicant.us/projects/replicant/wiki/SDK
> -   https://redmine.replicant.us/projects/replicant/wiki/NDKBuild
> -
>
> https://redmine.replicant.us/projects/replicant/wiki/CompatibilityTestSuite
>
> Others are totally irrelevant now, and thus I deprecated them:
>
> --------------------------------------------------------------------------------------------------------------------------------------------
>
> https://redmine.replicant.us/projects/replicant/wiki/DeprecatedReplicant42ADTBuild
> (neither ADT or Replicant 4.2 are maintained for a few years now).
>
> Regards,
> David
>
> Replicant mailing list
> Replicant at osuosl.org
> https://lists.osuosl.org/mailman/listinfo/replicant




More information about the Replicant mailing list