That’s alright @Kyle_Rankin.
Now put on your analytic hat for a minute.
Imagine a new customer wants to buy a Librem.
The likelihood they’ll read this post? Let’s say 50%.
In two weeks it’s 10%, in four weeks it’s 1%. Burried.
That’s one of the reasons I made the chronology. (That still doesn’t help new customers, but it helps the initiated who know about it, to browse all posts in a non-annoying manner)
So, a summary like this (your blog post) should also go out to new customers, e.g. in a “first steps” email.
But it still misses some valuable information.
Point them to
- the official FAQ
- the forum
- matrix channels
- maybe the community wiki (how are people supposed to figure out something like this exists?)
We know it’s overwhelming to keep the documentation up to date. The community can help to fill the gaps, but making it easy to find is on your part.
Speaking of which:
To my knowledge, the following resources are not linked or well hidden.
-
wiki.puri.sm (yes, go forward merging it with docs, you have my blessing )
-
developer.puri.sm (only via docs it seems. Plus, no links to (easy) development blog posts)
-
software.pureos.net (nice, but we’ll hidden)
- list of optimized apps
- list of features still in progress (camera, GPS navigation, suspend)
- fund your app
Sidenote on pureos.net: while it’s unexpected to find the repository hiding behind a link named “source”, I admit that it’s logical (and probably fsf demanded) to put the bug tracker and the pureos-wiki here (yet another wiki)
However. Your ordinary customer is unlikely to find it there. Probably add a a PureOS section to docs.puri.sm, and a Troubleshooting page to the Support menu that contains all troubleshooting resources (docs, wikis, bug tracker, support mail)
But back to the prospective customer. It’s good that you updated the L14 shipping info. This was also often outdated for the L5 in the past.
It could be a bit more pronounced though.
All good shops I use show a colored warning if an item is not in stock, plus an expected delay.
NOTE: this needs to be especially in the cart where you check your order before submitting. It’s nothing fancy, but a rather common and helpful practice.
Finally, as the Librem 5 is such a complex thing, I wish there was kind of a landing page for owners or wannabe owners, that gives an overview about a topic and points to all relevant resources of that topic.
For example, it has sections like
Getting started
Link to tested providers, AweSIM, …
Howto import contacts
Howto install messengers (Matrix, Signal, …)
Howto setup email
Howto backup
Howto use librem.one on L5
(Point out that AweSIM and Librem.one will always be optional. People don’t get that)
Status
Latest development reports
Roadmap / list of features still in progress (camera, GPS navigation, suspend)
Apps
Points to list of optimized apps
But also to software.pureos.net, pointing out that all should work, at least in convergence mode
Point to a howto video on installing Web apps.
What apps are currently in focus. Fund your app.
Community apps.
Goodies package.
Convergence
What is it (embed video)
What do I need to try it.
Which improvements can I expect. Goal for 2021.
PureOS
How to update
Philosophy, expected update lifetime
Docs
How to try OS image without flashing
Bug tracker
Improve / add layout to squeekboard
Development
developer.puri.sm
Easy App Development blog series
Librem 5 App Design Tutorial blog series
Point every new or prospective owner to that landing page. Seriously!
Reviewers also. Especially reviewers.
Three of four video reviews I’m aware of could have been so much better with some of the info that is definitely there somewhere, but not exactly easy to dig up for newcomers.
Bonus points: The L5 has a prominent link to that landing page, as a pre-installed web app.