docs.perl6.org design

[hankache]

It would be nice if the docs have the same design as the main perl6.org website. For consistency.

[gfldex]

http://examples.perl6.org/ is a related project and may need the same treatment.

[hankache]

Indeed an issue has been opened in the examples repo Raku/examples#46

[coke]

Turns out that because of how we build the docs, this isn't a simple cut and paste fix. Working on it now.

[coke]

This is kind of blocked by Raku/Pod-To-HTML#23 - it's generating a bunch of invalid HTML which makes it hard to work on the wrapper HTML

[tisonkun]

@coke

Raku/Pod-To-HTML#26

[zoffixznet]

Raku/Pod-To-HTML#26

(P.S.: the module on hack already updated with that PR so the docs build uses it)

[JJ]

That issue has been solved, so I guess this is no longer blocked. Are we still interested in this?

[zoffixznet]

Are we still interested in this?

IMO it'd be nice for them to be themed the same, but not necessarily to have the exact same design/layout, as they have different purposes and can be best fine-tuned for them. Rust lang does it how I'm picturing it: both main site and the The Book have the same minimalistic theme, but their designs are different, to suit different purposes of the sites.

So if, say, all of our sites would be using BootStrap 4, they could have their own layouts they need, but they could share a single theme file and so any changes to the theme would propagate to main site, docs, and examples site automatically.

---

That said, I'd say it's a waste of time to try to do that with the current htmlify.p6-based site. A dynamic site that has the docs stored in some database is a higher priority and would annul all the efforts spent into design/markup changes to htmlify.p6-based site.

---

same design as the main perl6.org website

P.S. in 2-3 months, perl6.org will see an update that'll have it upgraded to BootStrap 4 and the design might change slightly too.

[coke]

New site layout is available for review at raku/doc-website - please provide any feedback there.