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

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions