internetarchive / internetarchive/fatcat

language on releases

Open
#96 3 comments 0 reactions 0 assignees View on GitHub
Dominant language
Python
Stars
121
Forks
18
PR merge metrics
No merged PRs in 30d

Description

Greetings

currently the documentation states the following about language of the release:

```
language (string, slug): the primary language used in this particular release of the work. Only a single language can be specified; additional languages can be stored in "extra" metadata (TODO: which field?). This field should be a valid RFC1766/ISO639 language code (two letters). AKA, a controlled vocabulary, not a free-form name of the language.

```

1. for ISO639 if you want two letter codes ISO639-1 should be specified. ISO639 has 6 parts, the two letter codes comprise part one.

2. referencing RFC1766 is old form. [RFC 1766](https://tools.ietf.org/search/rfc1766) was obsoleted by [RFC 3066](https://tools.ietf.org/search/rfc3066) which was obsoleted by [RFC 4647](https://tools.ietf.org/search/rfc4647), which was obsoleted by [RFC 5646](https://tools.ietf.org/search/rfc5646). The stable way to reference this chain is to reference [BCP-47](https://tools.ietf.org/search/bcp47).

3. Is there a downstream technical reason to limit this field to two characters? instead of supporting BCP-47?

Contributor guide

No contributing guide indexed for this repository

Research direction

Start by reviewing the documentation passage quoted in the issue and the current definition of the release language field. Determine whether the ISO 639-1 and RFC references should be corrected and whether BCP-47 support has a downstream technical constraint; done means an agreed specification update or documented decision.

Written by the indexing model from the issue text.

Assessment

Domain
documentation
Issue type
Documentation
Difficulty
4/5
Estimated time
3-5 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
25/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.