scout-ch/docu

docu's Issues

NavItem und F.A.Q. title size on Mobile

Font sizes could be bigger.

• Check all @media entries in style.css
• Add entries for navitem class in all sizes
• Don't change navitem size for Desktop
• Add entries for F.A.Q. titles faq-title
• Don't change other sizes for Text
• Remove some margin from the top Tile on mobile

Einreichen Texte FR und IT fehlen

https://docu.scout.ch/fr/soumettre
https://docu.scout.ch/it/invia

Slugs containing "de", "fr" or "it" could be problematic

The new language switch replaces "de", "fr" and "it" in the URL. This could be a problem for urls with those texts in the slug (e.g. "fruit" or "iterations").

Several Options:

• replace the string with the slashes (e.g. "/de/")
• document the issue in the contributing file and hope no one adds a slug like this

See also #69

Open F.A.Q. entry when jumping to the hash value

It would be nice if the F.A.Q. entry opened up when accessing it by anchor-link (e.g. https://docu.scout.ch/fr/faq#combineacc)

See https://developer.mozilla.org/en-US/docs/Web/API/Window/hashchange_event

Anchors for F.A.Q.

Implement site anchors like https://stackoverflow.com/a/73846743 in faq.html (all languages).

Borders beim F.A.Q.

Erstes Element hat einen Border, andere nicht:
https://scout-ch.github.io/docu/de/faq

Gewünschtes Verhalten:
Alle F.A.Q.-Einträge haben einen (feinen) Border-Top und Border-Bottom

Einstiegsseite Tabs

Tabs haben Punkte, können wohl per CSS entfernt werden.

Sprache: Englisch entfernen

Standardmässig haben wir bei der PBS alle Inhalte in DE, FR und IT. Klar, die Webseite hat auch einzelne Inhalte in EN. Diese sind aber eher für das internationale Publikum vorgesehen.

Vorschlag: Sprache EN weglassen und den Link im Menu entfernen.

Contributions Text schreiben

Der Text sollte hier hinkommen:
https://scout-ch.github.io/docu/en/submit

Könnte ev. auch aufs Readme oder eben CONTRIBUTING.md zeigen

Jumping to hash-value only works in DE but not in FR?

#63

Maybe forgot the french html templates...

Allow staying on the same page when switching languages

See https://github.com/scout-ch/docu/compare/master...Michael-Schaer:docu:direct_lang_switch?expand=1

TODO:

• Harmonize permalinks
• Add simple search/replace mechanism for language buttons to stay on the same slug but different language
• Test if mechanism works in GitHub Pages as well
• Harmonize article slugs (e.g. article-6 in German is article-4 in french)
• Introduce new rule: All slugs are English and consistent between languages
• Update existing links to /release and /documentation or add redirects before merging

F.A.Q. Formatierung

DE ist schön, FR und IT irgendwie noch nicht.

Implement search

Every docu site needs a good search tool. With jekyll this is not as straight forward since there is no server logic to play around. We either need client side search including loading all the content in one page or an external indexing service.

Here is a lead for the client side search:
https://learn.cloudcannon.com/jekyll/jekyll-search-using-lunr-js/

URL https://docu.scout.ch 👍 👎

Wir sollten der Webseite eine passende URL vergeben. Das ist mit GitHub Pages recht einfach gemacht.

Vorschlag: https://docu.scout.ch

Einwände? Andere Ideen?