doc: add added

[tflanagan]

This is still a work in progress, as this will be a lot of changes, I figure the longer eyes can see it, the better.

This requires #3867

---

Introduces the YAML metadata concept and the "Added" property to the
documentation.

---

• assert.markdown

v0.1.21 530328f12b4a00dfbc8ea57bafb1f9344912f0db
ok, fail, equal, notEqual, deepEqual, notDeepEqual, strictEqual, notStrictEqual, throws
v0.1.21 4f679fd8d01c11c908bd5ca439a7aff956cda4ad
doesNotThrow
v0.1.97 fe3d8f2411209b202b7fe74cb48b582ffc5cfc5f
ifError
v0.5.9 8c8d51872361c0a30e56d2497daaf03a04c82849
assert = assert.ok
v1.2.0 3f473ef141fdc7059928ebc4542b00e2f126ab07
deepStrictEqual, notDeepStrictEqual

• modules.markdown
• repl.markdown

v0.1.92 b7441040f87ff5e0e7b4575852996b6a64e0ea8f
displayPrompt
start
v0.3.0 56df0cbf93f78daf905eae7bd66daf0910650a72
defineCommand
v0.7.0 3421f433519411c290c732c64dadbb6547e42235
data
v0.9.1 659d449460d84c40fc5b3bf0e23575378d72d312
exit
v0.11.8 eacdd4bf94edc8328f42e3591ba4dd79d347571
reset

• timers.markdown

v0.0.1 f213a276572a02fa9997c6e0375dc6de1a7333ba
setTimeout, setInterval, clearTimeout, clearInterval
v0.9.1 cd6122edebe09a66a3a1a3fd0904ffda39d9007b
ref, unref
v0.9.1 382f22f22959e686b10a5f42333c468e6654cb97
setImmediate, clearImmediate

• zlib.markdown

v0.5.8 5b8e1dabbc117b38c56f874f4e6d5b7e537cd3c1
Deflate, Inflate, Gzip, Gunzip, DeflateRaw, InflateRaw, Unzip
createDeflate, createInflate, createDeflateRaw, createInflateRaw, createGzip, createGunzip, createUnzip
flush, end, write, pause, resume

...adding to the list as I go

[mscdex]

I'm guessing this kind of data will eventually be visible on the API docs somehow?

[tflanagan]

@mscdex, yes, re: #3867

[TimothyGu]

Are there plans to migrate existing comment-style metadata to YAML?

<!--type=property--><!--name=[index]-->

[chrisdickinson]

@TimothyGu In the long term, yes — we're working to replace the old doctool with one powered by remark. The proposed Docs WG ROADMAP is available here.

[TimothyGu]

@chrisdickinson, looks very interesting. Thanks for the link!

[jasnell]

temporarily dropping the don't land on v4 label on this. once it's more complete we can look at backporting it all.

[tflanagan]

@jasnell, this one will take a week or two. It's quite a bit of manual work.

git log --all --reverse -S "<string>" --source

Checkout first commit, verify it exists, see if it existed but in a different fashion in the diff, if it did, research using that string, etc, etc

If anyone knows of a better method, I'm all ears

[jasnell]

Yeah, I don't envy your task :-)

[tflanagan]

Just an update, I've been really busy these last couple of months. I plan on finishing this, its not going anywhere, but its low on my list right now.

As this is quite the manual process I might be inclined to suggest we land the ability to parse and add the added information now (with what I've done so far) and let others have the chance to jump in for the rest.

[addaleax]

Closing this as this has conflicts + 2 of the files actually have been checked off in #6578, but I mentioned the remaining commits from this PR that may be useful there (both would be blocked by major doc file rewrites right now anyway).