[ Please note the cross-post and Reply-To ]
Hey folks,
As promised, here's a quick summary of what was discussed at the web
team BoF session in Hsinchu. Apologies for the delay in posting...
Thanks to the awesome efforts of our video team, the session is
already online [1]. I've taken a copy of the Gobby notes too,
alongside my small set of slides for the session. [2]
DebConf18 Web team BoF
3th August 2018, Hsinchu, Taiwan
Migration to git
Since the BoF last year, we finally managed to migrate away from CVS
to git. We managed it *just* before alioth went away. There was quite
a lot of work involved:
* Actual migration of the data and code from CVS to git, very slow
due to the huge repository we have full of many thousand small
files
* Changes to the translation helper and tracking scripts to use git
* Changes to the wml itself - some of the template pages contain
quite a lot of embedded perl which needed updating too. Also needed
updating to use git.
* Lots of work needed to make the new git-related code work with
acceptable performance. Builds a cache of git revisions to allow
for version comparisons that we used to do by directly comparing
CVS versions. In the end, website rebuilds are now much faster than
we were using CVS. \o/ Still not fast enough, but we have a very
large site...
* The workflow afterwards is *almost* the same, but had to change how
smart_change.pl works due to the way git works
* On the translation dashboards, we've had to drop the direct diff
links that we used to have. Instead we now have cut and paste
command lines for git diff commands. Needed as otherwise this
causes too much load on salsa and it times out on the links often.
Main point to take away: the migration has happened! It should now
allow us to work on more intrusive changes to our website that would
never have been feasible before. Hopefully it might now also encourage
more people to contribute, who were put off previously.
We already have merge requests coming in via salsa to make small
improvements to the website, which is a good sign! We can now be more
agile / more daring with rapid website changes.
Design work
---
There was already another session earlier during DebConf, run by
Thomas Lange [3], focussing on the www.d.o front page and top-level
pages. We could do with making these easier for *new* people to use,
to find out more about Debian and how to get involved. Most DDs rarely
use these pages, so we have a lot of content that is not actually
useful for any audience. We should improve this. See
https://informatik.uni-koeln.de/public/lange/debian-homepage/
as an example look from Thomas.
Steve's own pet project here is a clean new "download" page group to
replace the huge, scattered set of conflicting, out of date pages we
have now.
What else should we do with design? A new look?
Content
---
We have too much content on the website. Good content is great, but
very old stuff that hasn't been updated in a decade and is now
clearly out of date is really not helpful. Really old information for
users about how to use Debian isn't valuable, and is more likely to
put people off or maybe even be dangerous.
With too much content, it's also likely to put people off when they
want to change things. Which pages need changing? Which ones are users
actually finding? It's difficult to know, and demotivating.
Should we maybe split the website into multiple repos? We spoke about
this last year...
Suggested workflow for layout / page look changes:
* Go and work on a branch and make the changes
* Send a MR, and post screenshots alongside to show what the new
pages look like
That way, people can see what's proposed. Merging changes are easy,
even if we need to tweak translations afterwards.
We now (again!) have https://www-staging.debian.org/ available, thanks
to work from pabs. Maybe we could use that to compare before=and-after
changes.
Other points
* Build using GitLab CI? (this looks quite difficult! proposals welcome :-))
* More discussion with Thomas about changes to the front page
+ Why Debian? - add some simple points
+ Too much information in sentences - just remove lots of that, and
switch to links to further pages for more info
+ Remove the security updates links - just link to the security
tracker once, or a top-level /security/ page? The level of detail
on the front page right now is both too detailed and not detailed
enough, depending on POV
+ Remove the duplicated sets of links, in particular the blocks at
the top of the front page.
+ The "News" section is not great, just lists our stable and
oldstable updates. Is that really News? What about DebConf? Talks
by prominent DDs? Links to other people talking about Debian?
+ Make things more visual and welcoming
* Remove duplication - far too much of our information is found in
multiple
