Generation of documentation describing HTML5 support
Hi all, Safari has some documentation describing support for HTML/CSS/JS (see e.g. [1]). Creating and maintaining such documentation likely requires a significant amount of work. I don't know to what extent Apple folks may be able to share information about this, but how much of this process is automated? (e.g. are there tools that analyze parts of WebKit code to detect supported tags / attributes / etc.?) More generally, has some work been done in this field? (for WebKitGTK for instance) Thanks, Romain. [1] https://developer.apple.com/library/content/documentation/AppleApplications/...
On Thu, Sep 7, 2017 at 5:02 AM, Romain Bellessort <romain.wkt@gmail.com> wrote:
More generally, has some work been done in this field? (for WebKitGTK for instance)
We only document our C APIs. For web documentation I look at developer.mozilla.org and see what it has to say about WebKit. ;) Michael
2017-09-07 15:29 GMT+02:00 Michael Catanzaro <mcatanzaro@igalia.com>:
On Thu, Sep 7, 2017 at 5:02 AM, Romain Bellessort <romain.wkt@gmail.com> wrote:
More generally, has some work been done in this field? (for WebKitGTK for instance)
We only document our C APIs. For web documentation I look at developer.mozilla.org and see what it has to say about WebKit. ;)
I was expecting that kind of answer as this is also what I do when I need to check something :) Anyway, thanks for your response, it's useful to know/confirm that documentation is limited to C APIs. Romain.
07.09.2017, 13:03, "Romain Bellessort" <romain.wkt@gmail.com>:
Hi all,
Safari has some documentation describing support for HTML/CSS/JS (see e.g. [1]). Creating and maintaining such documentation likely requires a significant amount of work.
I don't know to what extent Apple folks may be able to share information about this, but how much of this process is automated? (e.g. are there tools that analyze parts of WebKit code to detect supported tags / attributes / etc.?) More generally, has some work been done in this field? (for WebKitGTK for instance)
https://webkit.org/status/ is automatically generated from features.json files. It has references to respective W3C standards/drafts.
Thanks, Romain.
[1] https://developer.apple.com/library/content/documentation/AppleApplications/... ,
_______________________________________________ webkit-dev mailing list webkit-dev@lists.webkit.org https://lists.webkit.org/mailman/listinfo/webkit-dev
-- Regards, Konstantin
2017-09-07 16:08 GMT+02:00 Konstantin Tokarev <annulen@yandex.ru>:
07.09.2017, 13:03, "Romain Bellessort" <romain.wkt@gmail.com>:
Hi all,
Safari has some documentation describing support for HTML/CSS/JS (see e.g. [1]). Creating and maintaining such documentation likely requires a significant amount of work.
I don't know to what extent Apple folks may be able to share information about this, but how much of this process is automated? (e.g. are there tools that analyze parts of WebKit code to detect supported tags / attributes / etc.?) More generally, has some work been done in this field? (for WebKitGTK for instance)
https://webkit.org/status/ is automatically generated from features.json files. It has references to respective W3C standards/drafts.
Thanks for your response. This isn't as low-level as Safari documentation, but it may be a good trade off. Regards, Romain.
Thanks, Romain.
[1] https://developer.apple.com/library/content/documentation/
AppleApplications/Reference/SafariHTMLRef/Introduction.html
,
_______________________________________________ webkit-dev mailing list webkit-dev@lists.webkit.org https://lists.webkit.org/mailman/listinfo/webkit-dev
-- Regards, Konstantin
participants (3)
-
Konstantin Tokarev
-
Michael Catanzaro
-
Romain Bellessort