[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