Project

General

Profile

Actions

action #68746

open

improve raspberry pi wiki pages

Added by lnussel almost 4 years ago. Updated over 3 years ago.

Status:
New
Priority:
Normal
Assignee:
-
Category:
Documentation
Target version:
-
Start date:
2020-07-08
Due date:
2020-07-31 (over 3 years late)
% Done:

0%

Estimated time:

Description

Raspberry Pi support deserves some extra attention wrt documentation. I'd like to link to those pages when clicking on the raspberry pi logo in the download page.

Right now there are pages for each rpi model with differnt kinds of documentation, some of them outdated:

https://en.opensuse.org/HCL:Raspberry_Pi
https://en.opensuse.org/HCL:Raspberry_Pi2
https://en.opensuse.org/HCL:Raspberry_Pi3
https://en.opensuse.org/HCL:Raspberry_Pi4

Also there are some nice articles that document extra attachments, especially the RTC one is important for MicroOS:
https://en.opensuse.org/HCL:Raspberry_Pi3_RTC

My suggestion would be to

  • [ ] rename HCL:Raspberry_Pi to HCL:Raspberry_Pi1
  • [ ] create a new HCL:Raspberry_Pi that explains the available boards and their difference (RPi1 is not really supported nor recommended anymore AFAIK)
  • [ ] identify sections common to several RPi versions and move each section to a separate subpage. Include the subpage in the board specific pages
  • [ ] create a category for the extra hardware documentation so there's an easy overview
  • [ ] find a way to indicate which board/OS combination this such a document applies to resp was tested with (similar to "tested on" in https://en.opensuse.org/SDB:System_upgrade)
  • [ ] create board specific known issues pages to be able to track stuff like https://bugzilla.opensuse.org/show_bug.cgi?id=1140688
Actions #1

Updated by lnussel almost 4 years ago

  • Category changed from Development to Documentation
Actions #2

Updated by cwh over 3 years ago

  • Assignee deleted (cwh)

Maybe this is better done by the ARM team.
My focus is on improving MicroOS/Kubic docu.

Actions

Also available in: Atom PDF