Skip to main content

Tools for write documentation in HTML/webpage and or other format

Some sites work without JS
https://www.webdesignerdepot.com/2018/01/8-sites-that-work-just-fine-without-js-thank-you/
You know what? Amazon and Twitter can work without JS!

I'm not biased and not a fan of choices (please read J. Krishnamurti) or comparison. But anyway I love simple, clean way of represent knowledge, information. In college, you can see many book, especially technical book are written in a very clear and easy to understand way, event it's problem is complex and or complicated. Art or psychological, social science ... are different ?

Some simple and amazing website content:
https://martinfowler.com/

Tools for write HTML, XML, code (certainly with highlight)...
From M. Fowler book - Patterns of EA Architecture.
See Colophon section:
This is the first book that I wrote using XML and related technologies. The
master text was written as a series of XML documents using trusty TextPad. I
also used a home-grown DTD. While I was working I used XSLT to generate
the web pages for the HTML site. For the diagrams I relied on my old friend
Visio using Pavel Hruby’s wonderful UML templates (much better than those
that come with the tool. I have a link on my Web site if you want them.) I wrote
a small program that automatically imported the code examples into the output, which saved me from the usual nightmare of code cut and paste. For my
first draft I tried XSL-FO with Apache FOP. At the time it wasn’t quite up to the
job, so for later work I wrote scripts in XSLT and Ruby to import the text into
FrameMaker.
I used several open source tools while working on this book—in particular,
JUnit, NUnit, ant, Xerces, Xalan, Tomcat, Jboss, Ruby, and Hsql. My thanks to
the many developers of these tools. There was also a long list of commercial
tools. In particular, I relied on Visual Studio for .NET and on IntelliJ’s wonderful Idea—the first IDE that’s excited me since Smalltalk—for Java.


Example of code hightlight very beautiful and simple from M. Fowler.
https://www.martinfowler.com/articles/refactoring-video-store-js/

Comments

Popular posts from this blog

Rand mm 10

https://stackoverflow.com/questions/2447791/define-vs-const Oh const vs define, many time I got unexpected interview question. As this one, I do not know much or try to study this. My work flow, and I believe of many programmer is that search topic only when we have task or job to tackle. We ignore many 'basic', 'fundamental' documents, RTFM is boring. So I think it is a trade off between the two way of study language. And I think there are a bridge or balanced way to extract both advantage of two method. There are some huge issue with programmer like me that prevent we master some technique that take only little time if doing properly. For example, some Red Hat certificate program, lesson, course that I have learned during Collage gave our exceptional useful when it cover almost all topic while working with Linux. I remember it called something like RHEL (RedHat Enterprise Linux) Certificate... I think there are many tons of documents, guide n books about Linux bu

Martin Fowler - Software Architecture - Making Architecture matter

  https://martinfowler.com/architecture/ One can appreciate the point of this presentation when one's sense of code smell is trained, functional and utilized. Those controlling the budget as well as developer leads should understand the design stamina hypothesis, so that the appropriate focus and priority is given to internal quality - otherwise pay a high price soon. Andrew Farrell 8 months ago I love that he was able to give an important lesson on the “How?” of software architecture at the very end: delegate decisions to those with the time to focus on them. Very nice and straight-forward talk about the value of software architecture For me, architecture is the distribution of complexity in a system. And also, how subsystems communicate with each other. A battle between craftmanship and the economics and economics always win... https://hackernoon.com/applying-clean-architecture-on-web-application-with-modular-pattern-7b11f1b89011 1. Independent of Frameworks 2. Testable 3. Indepe