On 2020-01-19 21:56, Mark Rotteveel wrote:
On 2020-01-19 19:32, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-19 18:58, Adriano dos Santos Fernandes wrote:
- A technical documentation does not need anything more than
markdown offers. Markdown sources are good directly and with tools
On 2020-01-19 19:32, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-19 18:58, Adriano dos Santos Fernandes wrote:
- A technical documentation does not need anything more than markdown
offers. Markdown sources are good directly and with tools help may be
used to produce docs in others
On 19-01-2020 10:30, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-18 12:03, Mark Rotteveel wrote:
On 17-01-2020 15:00, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-17 16:29, Mark Rotteveel wrote:
Hardly any of the documentation in the docs-folder have links, and
you can have links
On 2020-01-18 12:03, Mark Rotteveel wrote:
On 17-01-2020 15:00, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-17 16:29, Mark Rotteveel wrote:
Hardly any of the documentation in the docs-folder have links, and
you can have links in Markdown.
No named paragraphs. I have no idea how to
On 17.01.2020 16:29, Mark Rotteveel wrote:
On 2020-01-17 11:32, Dimitry Sibiryakov wrote:
17.01.2020 08:14, Mark Rotteveel wrote:
That is the whole point of markdown: that it is a human-readable
plain text file that can be converted to better looking HTML or PDF
with a tool.
The main
18.01.2020 10:03, Mark Rotteveel wrote:
When you diff, you need to read the source. And markdown is readable both in plain text
and in rendered output. That means that even if you only look at the raw source, it is
still readable.
I personally write HTML in a plain text editor and have no
On 17-01-2020 15:00, Alex Peshkoff via Firebird-devel wrote:
On 2020-01-17 16:29, Mark Rotteveel wrote:
Hardly any of the documentation in the docs-folder have links, and you
can have links in Markdown.
No named paragraphs. I have no idea how to create a link to specific
paragraph in MD.
I agree with Mark and Adriano. Especially for developer "docs".
--
Mgr. Jiří Činčura
https://www.tabsoverspaces.com/
Firebird-Devel mailing list, web interface at
https://lists.sourceforge.net/lists/listinfo/firebird-devel
On 17/01/2020 11:00, Alex Peshkoff via Firebird-devel wrote:
>
>
>> And if having HTML is important, I'd suggest to write the docs in
>> markdown (or maybe asciidoc) and generate HTML as part of the build
>> (eg using pandoc). That is what most other opensource projects do
>> these days. For good
On 2020-01-17 16:29, Mark Rotteveel wrote:
On 2020-01-17 11:32, Dimitry Sibiryakov wrote:
17.01.2020 08:14, Mark Rotteveel wrote:
That is the whole point of markdown: that it is a human-readable
plain text file that can be converted to better looking HTML or PDF
with a tool.
The main
17.01.2020 14:29, Mark Rotteveel wrote:
For good reasons: authoring and diffing is easier compared to HTML
Laziness in HTML editing with Office Suites is not a good reason IMHO. Hand-written
HTML has no difference from hand-written markup.
--
WBR, SD.
Firebird-Devel mailing list, web
On 2020-01-17 11:32, Dimitry Sibiryakov wrote:
17.01.2020 08:14, Mark Rotteveel wrote:
That is the whole point of markdown: that it is a human-readable plain
text file that can be converted to better looking HTML or PDF with a
tool.
The main feature of HTML/PDF is not a "better look" but a
17.01.2020 08:14, Mark Rotteveel wrote:
That is the whole point of markdown: that it is a human-readable plain text file that can
be converted to better looking HTML or PDF with a tool.
The main feature of HTML/PDF is not a "better look" but a fast navigation between parts
with hyperlinks
On 2020-01-16 18:14, Dimitry Sibiryakov wrote:
16.01.2020 18:10, marius adrian popa wrote:
This might help with some documentation that is in html format and to
generate the md version
What the point to change the format that can be displayed out-of-box
on any OS to the format that requires
16.01.2020 18:10, marius adrian popa wrote:
This might help with some documentation that is in html format and to generate
the md version
What the point to change the format that can be displayed out-of-box on any OS to the
format that requires preprocessing with some third-party tools to
This might help with some documentation that is in html format and to
generate the md version
https://github.com/xijo/reverse_markdown
https://github.com/FirebirdSQL/firebird/blob/master/doc/Using_OO_API.html
For example Using OO api is public only on ibase.ru in html format
16 matches
Mail list logo