Page MenuHomeFreeBSD

[website][ru]: Fix warning
AcceptedPublic

Authored by fernape on Fri, Oct 17, 4:31 PM.
Tags
None
Referenced Files
Unknown Object (File)
Mon, Oct 20, 2:13 AM
Unknown Object (File)
Mon, Oct 20, 2:13 AM
Unknown Object (File)
Sun, Oct 19, 11:58 AM
Unknown Object (File)
Sat, Oct 18, 8:33 AM
Unknown Object (File)
Fri, Oct 17, 11:55 PM
Unknown Object (File)
Fri, Oct 17, 7:16 PM
Unknown Object (File)
Fri, Oct 17, 6:52 PM
Unknown Object (File)
Fri, Oct 17, 6:27 PM
Subscribers

Details

Reviewers
carlavilla
andy
Group Reviewers
doceng
Doc Committers
Summary

"level 0 sections can only be used when doctype is book"

This comes from this review https://reviews.freebsd.org/D53041 that for some reason I'm not allowed to see.

In theory I think these comments should be ignored according to https://docs.asciidoctor.org/asciidoc/latest/document/header/#header-requirements-per-doctype but the fact is that they aren't .

Diff Detail

Repository
R9 FreeBSD doc repository
Lint
Lint Skipped
Unit
Tests Skipped
Build Status
Buildable 67870
Build 64753: arc lint + arc unit

Event Timeline

fernape created this revision.

We already discussed this issue internally, it must be fixed.
The technical reason of this error - though the document is in AsciiDoc format, the block delimited by --- is considered as YAML language block (assignment of 2 variables: title and sidenav), and --- must start at the 1st line of the file, otherwise it will be considered as AsciiDoc code with wrong syntax. That comment about original hash should be placed somewhere inside of the document.

Colleagues,

Take a look at the https://reviews.freebsd.org/D53187

It contains the fixes and update to the latest original version.
This revision is now accepted and ready to land.Sat, Oct 18, 1:11 PM