# [Discussion] HKDF - Thread: https://externals.io/message/97697 - Original archive: https://news-web.php.net/php.internals/97697 - Started by Tom Worster on 2017-01-11T19:16:57+00:00 - Messages: 9 - Reply by email to internals@lists.php.net - More for agents: search with https://externals.io/search.md?q={query} · JSON API at https://externals.io/api · documentation at https://externals.io/llms.txt --- ## #97697 — Tom Worster — 2017-01-11T19:16:57+00:00 URL: https://externals.io/message/97697#97697 Hi Andrey, Is there a draft of end-user docs for the PHP function? Tom --- ## #97699 — Andrey Andreev — 2017-01-11T19:39:44+00:00 URL: https://externals.io/message/97697#97699 · In reply to: #97697 Hi Tom, > Hi Andrey, > > Is there a draft of end-user docs for the PHP function? > No, not yet. But naturally, I do promise to write the docs + a userland compat package. In fact, I have some other docs updates that I want to do, so I might as well request VCS access for that ... the docs still being in SVN has been kind of demotivating. Cheers, Andrey. --- ## #97700 — Kalle Sommer Nielsen — 2017-01-11T20:38:03+00:00 URL: https://externals.io/message/97697#97700 · In reply to: #97699 Hi Andrey 2017-01-11 20:39 GMT+01:00 Andrey Andreev : > But naturally, I do promise to write the docs + a userland compat package. > In fact, I have some other docs updates that I want to do, so I might as > well request VCS access for that ... the docs still being in SVN has been > kind of demotivating. You can use the online editor[1] and submit a patch as well. You'll find the relevant documentation for ext/hash in: en/reference/hash/functions/ [1] http://edit.php.net/ -- regards, Kalle Sommer Nielsen kalle@php.net --- ## #97702 — Andrey Andreev — 2017-01-11T20:48:31+00:00 URL: https://externals.io/message/97697#97702 · In reply to: #97700 Hi Kalle, On Wed, Jan 11, 2017 at 10:38 PM, Kalle Sommer Nielsen wrote: > Hi Andrey > > 2017-01-11 20:39 GMT+01:00 Andrey Andreev : > > […] > package. > > […] > > You can use the online editor[1] and submit a patch as well. You'll > find the relevant documentation for ext/hash in: > en/reference/hash/functions/ > > > [1] http://edit.php.net/ Yes, I've used the online editor in the past. But it feels weird ... and I can't even see patches I've submitted in the past. If it has to happen quickly, I'll probably use that, but I'd rather avoid it. Cheers, Andrey. --- ## #97703 — Kalle Sommer Nielsen — 2017-01-11T21:06:32+00:00 URL: https://externals.io/message/97697#97703 · In reply to: #97702 Hi Andrey 2017-01-11 21:48 GMT+01:00 Andrey Andreev : > Yes, I've used the online editor in the past. But it feels weird ... and I > can't even see patches I've submitted in the past. > > If it has to happen quickly, I'll probably use that, but I'd rather avoid > it. Yeah sadly there is some fuzz going on there if you do not have a VCS account. Although I personally prefer SVN as it is much easier and faster. You can always make a diff there and send to the docs mailing list (and it will forever be stored, and searchable from indexing sites like markmail (our own NNTP site do not support search /o\))[1] or mail it to me directly and I'll commit it in case you are not granted a VCS account. [1] http://news.php.net/group.php?group=php.doc -- regards, Kalle Sommer Nielsen kalle@php.net --- ## #97705 — Niklas Keller — 2017-01-11T22:18:04+00:00 URL: https://externals.io/message/97697#97705 · In reply to: #97703 2017-01-11 22:06 GMT+01:00 Kalle Sommer Nielsen : > Hi Andrey > > 2017-01-11 21:48 GMT+01:00 Andrey Andreev : > > […] > I > > […] > > Yeah sadly there is some fuzz going on there if you do not have a VCS > account. Although I personally prefer SVN as it is much easier and > faster. You can always make a diff there and send to the docs mailing > list (and it will forever be stored, and searchable from indexing > sites like markmail (our own NNTP site do not support search /o\))[1] > or mail it to me directly and I'll commit it in case you are not > granted a VCS account. Could we move documentation to Git and mirror it on Github, too? I think we might get more PRs on GitHub than on this strange edit.php.net editor, where probably most people edit and save, but forget to submit the actual patch. Regards, Niklas --- ## #97706 — Christoph M. Becker — 2017-01-11T22:29:18+00:00 URL: https://externals.io/message/97697#97706 · In reply to: #97705 CC'ing the doc list. > 2017-01-11 22:06 GMT+01:00 Kalle Sommer Nielsen : > > > […] > > Could we move documentation to Git and mirror it on Github, too? I think we > might get more PRs on GitHub than on this strange edit.php.net editor, > where probably most people edit and save, but forget to submit the actual > patch. I also would welcome moving to Git. In my opinion the biggest problem with PhDOE is that you find a patch (whether submitted or not doesn't really matter) and sometimes you would need feedback – but you can't get it. -- Christoph M. Becker --- ## #97711 — Kalle Sommer Nielsen — 2017-01-11T23:04:00+00:00 URL: https://externals.io/message/97697#97711 · In reply to: #97705 Hi Niklas 2017-01-11 23:18 GMT+01:00 Niklas Keller : > Could we move documentation to Git and mirror it on Github, too? I think we > might get more PRs on GitHub than on this strange edit.php.net editor, where > probably most people edit and save, but forget to submit the actual patch. Both yes and no. It is no easy or small task. The main reason we still stick to SVN is that the $Rev$ is used for keeping translation in sync with the EN version (The "magic" tag, and all of our tools on doc.php.net is built around this, which means it needs a lot of work to make this change actually happen and a new and easy way (preferably in the same style as the current) for translators to easily syncing it. So far no one have started this movement, though we have talked about it, both on the phpdoc list and on IRC. I do not want to go in too much details here, to avoid hijacking the topic, but if you are interested in this project, then hit up the docs list or catch some of us on IRC (#php.doc @ EFNet) -- regards, Kalle Sommer Nielsen kalle@php.net --- ## #97712 — Joe Watkins — 2017-01-12T06:49:31+00:00 URL: https://externals.io/message/97697#97712 · In reply to: #97711 Morning Andrey, Please request a VCS account, put my name in it, and holla at me with username. Cheers Joe On Wed, Jan 11, 2017 at 11:04 PM, Kalle Sommer Nielsen wrote: > Hi Niklas > > 2017-01-11 23:18 GMT+01:00 Niklas Keller : > > […] > we > > […] > where > > […] > patch. > > Both yes and no. It is no easy or small task. The main reason we still > stick to SVN is that the $Rev$ is used for keeping translation in sync > with the EN version (The "magic" > tag, and all of our tools on doc.php.net is built around this, which > means it needs a lot of work to make this change actually happen and a > new and easy way (preferably in the same style as the current) for > translators to easily syncing it. So far no one have started this > movement, though we have talked about it, both on the phpdoc list and > on IRC. > > I do not want to go in too much details here, to avoid hijacking the > topic, but if you are interested in this project, then hit up the docs > list or catch some of us on IRC (#php.doc @ EFNet) > > -- > regards, > > Kalle Sommer Nielsen > kalle@php.net