Complete the glossary (an ongoing comprehensive (?) list)

[Blind4Basics]

docs/Glossary

Usage of the present thread

To keep this usable: if you wanna suggest ideas, post a reply to this issue. The maintainer/assignee will then update the present message.

Workflow:

• unchecked word: to add
• checked & crossed out: already added
• checked & not crossed out: just added, needs review

In addition, if you may find from time to time some of the following acronyms:

• W: to rewrite
• H: to review / need help or suggestions
• L: needs links to be added

---

Additional information about how to complete the glossary:

Example

- term: Test Driven Development
  description: A software development process ...
  acronym: TDD
  see: /path/to/a-page/
  links:
    - title: Test-driven Development (Wikipedia)
      url: https://en.wikipedia.org/wiki/Test-driven_development

Structure

type Term {
  id: string;                // (Optional on the user's side) Slugified word. Must be unique. Assigned with `slugify(term)` if unspecified.
  term: string;              // The term in our glossary
  description?: string;      // Description of the term in Markdown. Converted to HTML during build.
  acronym?: string;          // (Optional) acronym form.
  see?: string;              // (Optional) path to a PAGE in our docs. The title will be set automatically
  links?:                    // (Optional) List of external links
     {title: string; url: string}[];
}

The id can be used to link directly to the word

Multiline stuff/descriptions

Use | on the first line

Formatting

Markdowns are supported

Links (see docs guidelines/links)

• Never put a link on the term property (using markdowns)
• links: for external links. Opens the link in a new tab
• see: for internal links, but only to a page, not to an anchor in the page. Opens the link in the current tab.
• To link an entry of the glossary to another one, put the link in the description, using regular markdown. Opens the link in the current tab.

  ...
  - description: See [example tests](/glossary/#example-tests-id)

Traps

Careful with descriptions/strings that contains a colon :...

    description: |
        for katas: blablabla                   // -> WORKS

    description: for katas: blablabla          // -> FAILS

---

State of the art...

• [x] abandoned kata
• [x] active (author)
• [x] L - allies
• [x] approve (kata/translation)
• [x] attempt
• [x] author
• [ ] 'best practices" votes
• [x] L - beta (kata/process)
• [x] L - clan(s) (generic link to use when created)
• [ ] "clever" votes
• [x] L - collection(s) (generic link to use when created)
• [x] console
• [x] contributor(s)
• [x] dans
• [x] dashboard
• [x] draft (kata)
• [x] duplicate (Kata)
• [x] edit panel
• [x] example tests
• [x] fixed tests
• [x] L - followers
• [x] forfeit (a kata)
• [x] fork (of a solution)
• [x] honor (need to redact/update the honor/rank files)
• [x] inactive (author)
• [x] initial solution
• [x] L - Issue (comment) (link no writen yet)
• [x] L - kata
• [x] L - kata (search) page
• [ ] kumite
• [x] kyus
• [x] language version (with eventual remark on ambiguity of the term, i.e. java version of a kata vs. Mono/C# 7/ C# 8 runtimes
• [x] leaderboard (TODO: detailed article ?)
• [x] markdowns
• [x] L - merge conflict (tutorial about translations to write)
• [x] L - mutation of the input (article to write)
• [x] L - output panel
• [ ] performances tests
• [x] preloaded (code snippet)
• [x] progress (need to redact/update the honor/rank files)
• [x] L - Question (comment) (link no writen yet)
• [x] random tests
• [x] randomized tests
• [x] rank
• [ ] reference solution (ie. solution of the translator/author, at kata/translation creation / to "nuancate" with the one used for random tests)
• [x] reject (translation)
• [x] L - retire/ed (kata, auto-retirement)
• [x] L - sample tests
• [x] satisfaction rating
• [x] sensei
• [x] solution setup (= initial solution)
• [ ] spoiler flag
• [ ] submission tests
• [x] "submit final"
• [x] L - suggestion label (comments) (link not writen yet)
• [x] TDD
• [x] test cases
• [x] test suite
• [x] L - trainer (kata)
• [x] trainer suggestions
• [x] translation
• [x] translator
• [x] unpublish

[hobovsky]

Is it possible to have the definitions linking/referencing themsleves?

I believe that's how see, and possibly link sections work in the template described here? https://github.com/codewars/docs/issues/9#issuecomment-655477654

[kazk]

see is used for internal link. Set this to a path to the document and the title will be automatically filled. It'll show up under the description like See Title.

links are used for external links. You need to specify the title and the url.

https://github.com/codewars/docs/blob/f45064a7d07bb5ae50d75d0c423a47233ed5e56d/data/glossary.yml#L28-L32

[Blind4Basics]

are some formatting elements possible in the descriptions? (bold, italic, colors, ...?) I guess it's only raw text?
Multiline descriptions, maybe?

[kazk]

Description supports Markdown. https://github.com/codewars/docs/blob/f45064a7d07bb5ae50d75d0c423a47233ed5e56d/data/glossary.yml#L12-L13 https://github.com/codewars/docs/blob/f45064a7d07bb5ae50d75d0c423a47233ed5e56d/data/glossary.yml#L62-L68

https://docs.codewars.com/glossary/

[hobovsky]

Suggestions:

• contributor
• beta kata
• to accept/to approve (whichever is correct term) a beta or a translation
• to reject
• retired kata
• fork
• merge conflict
• abandoned kata
• active/inactive author
• to forfeit (a kata)
• trainer suggestions
• issue
• question
• suggestion
• draft
• to publish
• to unpublish

from B4B: added

[Blind4Basics]

if someone can tell me what I did wrong in that attempt...?
Bed time, here. cheers.

[hobovsky]

I'd suggest leaving entries in initial post which were already added to the glossary, eventually just dim them, strike through, or mark with a check. This way it will be easier to see if some new entry needs to be suggested or not.

[Blind4Basics]

@hobovsky : I tried with checked boxes... But I see anyone can update them, apparently... => bad idea, I guess?

[hobovsky]

It's very nice IMO, I meant to see what's in and what's not to avoid suggestions of terms which are already added. As long as we don't mess up the boxes , they should be good

[Blind4Basics]

As long as we don't mess up the boxes

that's especially the part that is worrying me x) (it's subject to accidents...)

unrealted: any idea why the build isn't working in #31 ? x/

EDIT: actually, not a problem at all x) if you click on some, the changes aren't saved. So it's good to go.

[Blind4Basics]

to add/check: #154