liberusoftware / liberusoftware/documentation

BOILERPLATE.md is physically triplicated under a single H1

Open Beginner friendly
#24 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

Dominant language
No language data
Stars
4
Forks
0
PR merge metrics
No merged PRs in 30d

Description

projects/boilerplate/BOILERPLATE.md contains its full body three times under a single H1.

The run from ## Canonical Application Foundation Scope through ## 20 appears at:

  • lines 3–329
  • lines 330–656
  • lines 657–982

The three copies are byte-identical as far as checked. This is almost certainly a bad concatenation rather than intent.

Why it matters beyond tidiness

A reader citing "BOILERPLATE.md §8" has three §8s to choose from, and a tool that extracts sections by heading will pick whichever it hits first. The document is normative for the 28 foundation modules — it is the only per-capability text that is not a template — so section references into it are load-bearing.

Also worth confirming while in here

§3's catalogue table is 28 rows, while core/ holds 29 files. The 29th is README.md, an index whose own table also lists 28. If anything downstream tracks 29 foundation modules, one of them has no catalogue row.

Found while auditing ecommerce-laravel against the standards.

Contributor guide

No contributing guide indexed for this repository

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Open projects/boilerplate/BOILERPLATE.md and compare the three stated line ranges, confirming they are byte-identical and leaving one canonical copy. Then inspect the §3 catalogue and core/README.md against the 29 files in core/; done means the document has one body and any missing catalogue row is identified and reconciled.

Written by the indexing model from the issue text.

Assessment

Tech stack
laravel
Domain
documentation
Issue type
Documentation
Difficulty
2/5
Estimated time
1-3 hours
Activity status
Quiet
Clarity
Clearly specified
Newbie friendliness
78/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.