--description--

Objective: Build an app that is functionally similar to <a href="https://technical-documentation-page.freecodecamp.rocks" target="_blank" rel="noopener noreferrer nofollow">https://technical-documentation-page.freecodecamp.rocks</a>. Do not copy this demo project.

User Stories:

You can see a main element with a corresponding id="main-doc", which contains the page's main content (technical documentation)
Within the #main-doc element, you can see several section elements, each with a class of main-section. There should be a minimum of five
The first element within each .main-section should be a header element, which contains text that describes the topic of that section.
Each section element with the class of main-section should also have an id that corresponds with the text of each header contained within it. Any spaces should be replaced with underscores (e.g. The section that contains the header "JavaScript and Java" should have a corresponding id="JavaScript_and_Java")
The .main-section elements should contain at least ten p elements total (not each)
The .main-section elements should contain at least five code elements total (not each)
The .main-section elements should contain at least five li items total (not each)
You can see a nav element with a corresponding id="navbar"
The navbar element should contain one header element which contains text that describes the topic of the technical documentation
Additionally, the navbar should contain link (a) elements with the class of nav-link. There should be one for every element with the class main-section
The header element in the #navbar must come before any link (a) elements in the navbar
Each element with the class of nav-link should contain text that corresponds to the header text within each section (e.g. if you have a "Hello world" section/header, your navbar should have an element which contains the text "Hello world")
When you click on a navbar element, the page should navigate to the corresponding section of the #main-doc element (e.g. If you click on a .nav-link element that contains the text "Hello world", the page navigates to a section element with that id, and contains the corresponding header)
On regular sized devices (laptops, desktops), the element with id="navbar" should be shown on the left side of the screen and should always be visible to the user
Your technical documentation should use at least one media query

Fulfill the user stories and pass all the tests below to complete this project. Give it your own personal style. Happy Coding!

Note: Be sure to add <link rel="stylesheet" href="styles.css"> in your HTML to link your stylesheet and apply your CSS

--hints--

You should have a main element with an id of main-doc.

const el = document.getElementById('main-doc');
assert.isNotNull(el);

You should have at least five section elements with a class of main-section.

const els = document.querySelectorAll('#main-doc section');
assert.isAtLeast(els.length, 5);

All of your .main-section elements should be section elements.

const els = document.querySelectorAll('.main-section');
els.forEach(el => {
  if (el.tagName !== 'SECTION') {
    assert.fail();
  }
});
assert.isAbove(els.length, 0);

You should have at least five .main-section elements that are descendants of #main-doc.

const els = document.querySelectorAll('#main-doc .main-section');
assert.isAtLeast(els.length, 5);

The first child of each .main-section should be a header element.

const els = document.querySelectorAll('.main-section');
els.forEach(el => {
  if (el.firstElementChild?.tagName !== 'HEADER') assert.fail();
});
assert.isNotEmpty(els);

None of your header elements should be empty.

const els = document.querySelectorAll('header');
els.forEach(el => {
  if (el.innerText?.length <= 0) assert.fail();
});
assert.isNotEmpty(els);

All of your .main-section elements should have an id.

const els = document.querySelectorAll('.main-section');
els.forEach(el => {
  if (!el.id || el.id === '') assert.fail();
});
assert.isNotEmpty(els);

Each .main-section should have an id that matches the text of its first child, having any spaces in the child's text replaced with underscores (_) for the id's.

const els = document.querySelectorAll('.main-section');
els.forEach(el => {
  const text = el.firstElementChild?.innerText?.replaceAll(' ', '_');
  if (el.id?.toUpperCase() !== text?.toUpperCase()) assert.fail();
});
assert.isNotEmpty(els);

You should have at least 10 p elements (total) within your .main-section elements.

const els = document.querySelectorAll('.main-section p');
assert.isAtLeast(els.length, 10);

You should have at least five code elements that are descendants of .main-section elements.

const els = document.querySelectorAll('.main-section code');
assert.isAtLeast(els.length, 5);

You should have at least five li elements that are descendants of .main-section elements.

const els = document.querySelectorAll('.main-section li');
assert.isAtLeast(els.length, 5);

You should have a nav element with an id of navbar.

const el = document.getElementById('navbar');
assert.isNotNull(el);
assert.strictEqual(el.tagName, 'NAV');

Your #navbar should have exactly one header element within it.

const els = document.querySelectorAll('#navbar header');
assert.lengthOf(els, 1);

You should have at least one a element with a class of nav-link.

const els = document.querySelectorAll('a.nav-link');
assert.isAtLeast(els.length, 1);

All of your .nav-link elements should be anchor (a) elements.

const els = document.querySelectorAll('.nav-link');
els.forEach(el => {
  if (el.tagName !== 'A') assert.fail();
});
assert.isNotEmpty(els);

All of your .nav-link elements should be in the #navbar.

const els1 = document.querySelectorAll('.nav-link');
const els2 = document.querySelectorAll('#navbar .nav-link');
assert.isNotEmpty(els2);
assert.strictEqual(els1.length, els2.length);

You should have the same number of .nav-link and .main-section elements.

const els1 = document.querySelectorAll('.main-section');
const els2 = document.querySelectorAll('.nav-link');
assert.isNotEmpty(els1);
assert.isNotEmpty(els2);
assert.strictEqual(els1.length, els2.length);

The header element in the #navbar should come before any link (a) elements also in the #navbar.

const navLinks = document.querySelectorAll('#navbar a.nav-link');
const header = document.querySelector('#navbar header');
navLinks.forEach(navLink => {
  if (
    header.compareDocumentPosition(navLink) & Node.DOCUMENT_POSITION_PRECEDING
  )
    assert.fail();
});
assert.isNotNull(header);

Each .nav-link should have text that corresponds to the header text of its related section (e.g. if you have a "Hello world" section/header, your #navbar should have a .nav-link which has the text "Hello world").

const headerText = Array.from(document.querySelectorAll('.main-section')).map(
  el => el.firstElementChild?.innerText?.trim().toUpperCase()
);
const linkText = Array.from(document.querySelectorAll('.nav-link')).map(el =>
  el.innerText?.trim().toUpperCase()
);
const remainder = headerText.filter(str => linkText.indexOf(str) === -1);

assert.isNotEmpty(headerText);
assert.isNotEmpty(linkText);
assert.isEmpty(remainder);

Each .nav-link should have an href attribute that links to its corresponding .main-section (e.g. If you click on a .nav-link element that contains the text "Hello world", the page navigates to a section element with that id).

const hrefValues = Array.from(document.querySelectorAll('.nav-link')).map(el =>
  el.getAttribute('href')
);
const mainSectionIDs = Array.from(
  document.querySelectorAll('.main-section')
).map(el => el.id);
const missingHrefValues = mainSectionIDs.filter(
  str => hrefValues.indexOf('#' + str) === -1
);
assert.isNotEmpty(hrefValues);
assert.isNotEmpty(mainSectionIDs);
assert.isEmpty(missingHrefValues, 0);

Your #navbar should always be on the left edge of the window.

const el = document.getElementById('navbar');
const left1 = el?.offsetLeft;
assert.isNotNull(el);
assert.isAtLeast(left1, -15);
assert.isAtMost(left1, 15);

Your Technical Documentation project should use at least one media query.

const htmlSourceAttr = Array.from(document.querySelectorAll('source')).map(el =>
  el.getAttribute('media')
);
const cssCheck = new __helpers.CSSHelp(document).getCSSRules('media');
assert.isTrue(cssCheck.length > 0 || htmlSourceAttr.length > 0);

--seed--

--seed-contents--

html

css

--solutions--