[asterisk-dev] [External] Re: Final Preview: docs.asterisk.org

George Joseph gjoseph at sangoma.com
Wed Aug 9 17:05:57 CDT 2023


On Wed, Aug 9, 2023 at 2:30 PM <asterisk at phreaknet.org> wrote:

> On 8/9/2023 11:12 AM, George Joseph wrote:
> >
> >
> > On Wed, Aug 9, 2023 at 8:39 AM Joshua C. Colp <jcolp at sangoma.com
> > <mailto:jcolp at sangoma.com>> wrote:
> >
> >     On Wed, Aug 9, 2023 at 11:37 AM Floimair Florian
> >     <f.floimair at commend.com <mailto:f.floimair at commend.com>> wrote:
> >
> >         Thanks Josh!
> >
> >         I went the same path actually but gave up, as CSS to me is
> >         something completely out of my knowledge domain.
> >
> >         I also had a look at the other teams but so far Material for
> >         mkdocs does still look like the best option out there readily
> >         available.
> >
> >
> >     Then I'd suggest filing an issue on the Github repo with your
> >     comments so they don't get lost. No guarantee anything can be
> >     done, but the docs repo is where issues should go.
> >
> >
> > Yeah, create an issue.  I can take a look in the coming weeks.  If you
> > constrict the width of your browser, at some point, the left nav bar
> > will collapse and you can get it back by clicking on the "hamburger"
> > button that then appears in the top-left of the page.  There's no way
> > to collapse it manually though so maybe we can find a way to add that.
> > Maybe we can also make the page table of contents collapsible.  Both
> > should give more space to the content.  I think we can also override
> > the viewport width of the content.    A tweak to the dynamic
> > documentation generator might also help.
>
> I don't think the issue here is collapsing the navigation. In fact, I
> really hate when you're on a large monitor and websites collapse menus
> like that, catering to mobile devices only is pure insanity, making life
> more difficult for everyone else by requiring yet more clicks to do
> anything. The issue is that the site seems to max out at a certain
> viewport; on a large monitor, the middle portion could take up more
> room, but there is vast whitespace to the left and right margins. It's
> possible that the style is assuming a max-width that it will use for
> presentation. Ideally, the middle content should expand to take up the
> space it can so it can use the full width of any monitor.
>


Yeah I get it.  I was just throwing out some additional ideas as well.
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://lists.digium.com/pipermail/asterisk-dev/attachments/20230809/1578220f/attachment.html>


More information about the asterisk-dev mailing list