If you use undefined tags, or if you don’t follow the rules, your document isn’t DocBook anymore (and DocBook-supporting processing tools may break on it).ĭocBook tags always convey structure and semantics (meaning), never makeup. The DocBook DTD defines a limited number of tags, and it gives exact rules on how to use them: what attributes are possible for a tag A, whether element B can be nested within element C, and so on. The posting frequency can be very low at times, but rest assured that if you post there, your message will be read, and replied to. Talk about your ideas – or your search for ideas – on the firebird-docs list. Or maybe you can supply raw documentation material for a subject you know a lot about. Maybe you can write one or more chapters for a book. Maybe there are already people working on a larger production, which you can contribute to. You don’t necessarily have to write an entire book, guide or article. The most logical choice would be a topic you are familiar with, but you can also pick a subject you’d have to learn more about first (this is much more work of course, but a great learning experience if you’re willing to invest the time). Then ask yourself what’s missing, and what may be useful for Firebird users in general, or perhaps just for a specific group.Īlso ask yourself what you would like to write about. Translator’s notices in DocBookįirst make sure you know what’s already there – nobody’s waiting for three MS-SQL-to-Firebird conversion guides. A copyright notice at the start in DocBook Program listings, screens, literal layout, and examples A copyright notice at the start in AsciiDoc Firebird documentation AsciiDoc code style AsciiDoc and Asciidoctor - an introduction Updating the Firebird Documentation Index Publishing your document on the Firebird website Dos and don’ts if you have received commit rights Adding your document to the firebird-documentation repository Attaching the entire Public Documentation License
0 Comments
Leave a Reply. |