13 Commits

Author SHA1 Message Date
Manny Becerra
019d80976d
📃 Adds Frequently Asked Questions (FAQs) Page (Issue #246) (#288)
* Initial Frequently Asked Questions (FAQs) page that is a child to the Documentation page and cross-linked accordingly. Corresponds to issue #246

* Cross-referencing and linking to the new FAQs page (b55ec86) from the Contributing Guidelines docs. Corresponds to issue #246

* Doh! Inadvertently removed the `Get Help` sub-heading under c98290e; this commit adds `Get Help` back

* linting - updating unordered bullets to dash instead of asterisk

* adding copy and link to joining the Self-Defined app Slack community per feedback from Tatiana

* Update 11ty/documentation/index.md

Feedback from Tatiana

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* Update 11ty/documentation/frequently-asked-questions.md

Copy feedback from Tatiana

Co-authored-by: Tatiana Mac <github@tatianamac.com>

* tidying up copy for FAQs page per Tatiana feedback, specifically under `Open PR`

* additional copy cleanup and updates per Tatiana PR feedback

* converting the FAQ markdown page (b55ec86, 5552abd) to a njk html template since we're utilizing dl, dt & dd markup tags for our FAQ content. Changes include corresponding CSS rules for dl and dt tags and minor punctuation update in the contributing guidelines. Addresses issue #246

Co-authored-by: Manny Becerra <mannybecerra@users.noreply.github.com>
Co-authored-by: Tatiana Mac <github@tatianamac.com>
2020-08-31 20:40:40 -07:00
Fábio Costa
7df23a427c
Includes missing repository link on development documentation. (#273)
* Includes missing repository link on development documentation.

* Contributing section in development documentation

* moved contributing reference in documentation to introduction.

* Update 11ty/documentation/development.md

Co-authored-by: Tatiana Mac <github@tatianamac.com>

Co-authored-by: Oscar <ovlb@users.noreply.github.com>
Co-authored-by: Tatiana Mac <github@tatianamac.com>
2020-08-28 17:14:23 +02:00
Kathryn Grayson Nanz
b872dbe384
Add new front matter element: excerpt (#227)
* This commit adds the excerpt front matter element, to show an
abbreviated version of the definition in social previews. This
also includes the documentation updates to support this change.

* This commit adds @olvb's suggestion to use 'set' to define the
alert & preview combo, to avoid repetitive code

* This commit updates the preview text to only include the flag if
it's "avoid" – if the flag is "warning" or there is no flag, it
will not appear at the beginning of the preview text.

Co-authored-by: Kathryn Grayson Nanz <kathryn@Kathryns-MacBook-Air.local>
Co-authored-by: Oscar <ovlb@users.noreply.github.com>
Co-authored-by: Kathryn <>
2020-08-24 19:41:45 +02:00
David Peter
6f0a29f859
🐛 Modernize legacy definition deep-linking (#203)
Co-authored-by: Tatiana Mac <tatiana.t.mac@gmail.com>
2020-06-10 17:24:54 -07:00
Tatiana Mac
9719d5a56f
Adds sanity check (#119)
*  Add misia, update fatphobia

* ✏️ Applied PR revisions

* 🐛 Resolve build error

* [WIP] term

* [WIP] draft for sanity check

* [WIP] draft for sanity check

* [WIP] draft of sane

* ✏️ Appends copy edits from review

* Resolves merge conflicts
2020-05-13 20:58:26 -07:00
Oscar
bd88c18fd0
📄 Add Detail Pages for Definitions (#75)
* fix: untrack definitions in dist

* feat(detail pages): update item link

* feat(detail pages): add layout

* feat(detail pages): render whole definition content

* feat(detail pages): remove definitons from homepage

* 🧹 def list component

* feat(layout): render site footer in all pages

* feat(detail pages): rename definition root class && move css into partials

* chore: abstract further css into own files

* feat(detail pages): update headling level of definition content

* feat(styles): set box sizing

* feat(styles): add margin bottom utility

* feat(styles): selection

* feat(components): sub page header own component

* feat(detail pages): add sections

* feat(style): mian headline

* feat(page layout): rename page content grid

* feat(page layout): add wide content class

* feat(detail pages): set document title

* feat(detail pages): set uniform document title for docs and definitions

* feat(page title): add comment

* feat(detail pages): add meta description

* feat(detail pages): wrap def header in article tag

* chore: set up ava

* feat(filters): move permalink function into file, add test

* chore: rename _temp to _util, remove creation script

* feat(detail pages): helper function to find additional definitions

* chore: move helpers to single directory

* feat(detail pages): create shortcode for further definition navigation

* feat(detail pages): fix find defs function

* feat(detail pages): shortcode for browse nav markup

* chore: fix collection mock data

* feat(detail pages): render browse nav

* feat(detail pages): style browse nav, style improvements

* feat(detail pages): test redirect

* feat(detail pages): client side redirect

* feat(homepage): set title

* 💅

* feat(detail pages): incorporate design changes

* feat(detail pages): hide browse headlines

* feat(detail pages): label lists

* feat(footer): add aria label

* feat(detail pages): redice heading level in md

* feat(detail pages): spacing in browse nav

* feat(detail pages): reduce line height

* feat(detail pages): set max width w/o breaking homepage

* feat(detail pages): replace in-definition definition links

* 🧹

* feat(detail pages): recover spacing utility

* 🧹

* chore(packages): update ava

* config: specify nvm version

* 💅

* 💅
2020-03-09 15:47:06 -07:00
Oscar
58ba26142c docs: add dev guide 2019-11-22 13:12:50 +01:00
Oscar
fbac4429ac typography: use english style quotation marks 2019-11-18 22:57:49 +01:00
Oscar
2177586008 docs: add basic && flagged word examples 2019-11-18 22:40:35 +01:00
Oscar
731e43e854 docs: link to complete examples from front matter page 2019-11-18 22:40:03 +01:00
Oscar
0a2d6bf288 docs: fix headline breaking the layout 2019-11-18 21:36:10 +01:00
Oscar
f9d7c96b03 docs: fix code highlighting 2019-11-18 21:35:48 +01:00
Oscar
4db1675b24 docs: add front matter documentation 2019-11-17 22:28:50 +01:00