Skip to content

Consider .adoc extension #11

@tomschr

Description

@tomschr

Situation

Currently, all the source files end with .txt.

Suggestion

Why not use .adoc as a file extension? This has some benefits:

  • Small change, big impact.
  • GitHub renders .adoc automatically when you open them on their web site.
  • Easier to read than the raw source code.
  • Supports your readers, they don't have to build the book.

Of course it won't be perfect, but nobody expects that. 😉

Example

https://github.com/SUSE/doc-susemanager/blob/master/modules/administration/pages/icinga.adoc

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions