search

jupyter / jupyter-alabaster-theme

BSD 3-Clause "New" or "Revised" License
2 stars 15 forks source link

Various issues. #88

Open Carreau opened 6 years ago

Carreau commented 6 years ago

This theme has a number of layour, redability and usability issue on various device and contexts;

I suggest deprecating it and resting to normal RTD theme.

ellisonbg commented 6 years ago

Yeah, I am bummed. We had two people put months worth of work into this - those two folks have moved on to other jobs, so there is no one to work on it. I know the current state isn't great, and there isn't anyone to dive into it right now ;-(

I am fine if folks want to revert to RTD uniformly until we have a solid replacement. There are many advantages to using a single docs theme across our entire project and our custom theme probably isn't the right one. At the same time, there are significant usability issues with the RTD theme that this project began to fix. I don't want us to entirely abandon that direction either.

Also for the record, we spent a good amount of time trying to modify the RTD theme itself - the CSS and layout of the RTD is extremely painful to work on in any significant way.

defeated

On Wed, Oct 18, 2017 at 10:36 PM, Matthias Bussonnier < notifications@github.com> wrote:

This theme has a number of layour, redability and usability issue on various device and contexts;

  • No Prev/Next button;
  • Inconsistan margin
  • Inconsistan font size
  • No links to source
  • inconsistant font underline and weight
  • No really readable
  • inconsistent navbar on top that is out of sync with jupyter.org.

I suggest deprecating it and resting to normal RTD theme.

— You are receiving this because you are subscribed to this thread. Reply to this email directly, view it on GitHub https://github.com/jupyter/jupyter-alabaster-theme/issues/88, or mute the thread https://github.com/notifications/unsubscribe-auth/AABr0FaMnA2Nh-5FWEZ7CVLhKbCa5k2mks5stt_ggaJpZM4P-uKE .

-- Brian E. Granger Associate Professor of Physics and Data Science Cal Poly State University, San Luis Obispo @ellisonbg on Twitter and GitHub bgranger@calpoly.edu and ellisonbg@gmail.com

Carreau commented 6 years ago

Thanks Brian,

I think it is ok to deactivate and restart the work later; I use RTD theme as an example, i'm happy to switch to another (like classic alabaster) if you like; but I think the Jupyter-albaster theme have more significant usability issue than RTD-default; one of them being navigation; we just finished a workshop in UC Davis on honestly the Jupyter theme is far from being great usability wise. I've attempted to also fix some layout issue – I'm not the only one – but the way the style was overwritten was far from standard, and relatively hard to follow.