Welcome! Log In Create A New Profile

Advanced

[PHP-DEV] Re: [Discussion] HKDF

Posted by Tom Worster 
Tom Worster
[PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 08:20PM
Hi Andrey,

Is there a draft of end-user docs for the PHP function?

Tom

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
Andrey Andreev
[PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 08:50PM
Hi Tom,

On Wed, Jan 11, 2017 at 9:16 PM, Tom Worster <fsb@thefsb.org> wrote:

> 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.
Kalle Sommer Nielsen
Re: [PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 09:40PM
Hi Andrey

2017-01-11 20:39 GMT+01:00 Andrey Andreev <narf@devilix.net>:
> 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

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
Andrey Andreev
Re: [PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 09:50PM
Hi Kalle,

On Wed, Jan 11, 2017 at 10:38 PM, Kalle Sommer Nielsen <kalle@php.net>
wrote:

> Hi Andrey
>
> 2017-01-11 20:39 GMT+01:00 Andrey Andreev <narf@devilix.net>:
> > 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/


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.
Kalle Sommer Nielsen
Re: [PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 10:10PM
Hi Andrey

2017-01-11 21:48 GMT+01:00 Andrey Andreev <narf@devilix.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.

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

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
Niklas Keller
Re: [PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 11:20PM
2017-01-11 22:06 GMT+01:00 Kalle Sommer Nielsen <kalle@php.net>:

> Hi Andrey
>
> 2017-01-11 21:48 GMT+01:00 Andrey Andreev <narf@devilix.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.
>
> 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
Christoph M. Becker
Re: [PHP-DEV] Re: [Discussion] HKDF
January 11, 2017 11:40PM
CC'ing the doc list.

On 11.01.2017 at 23:18, Niklas Keller wrote:

> 2017-01-11 22:06 GMT+01:00 Kalle Sommer Nielsen <kalle@php.net>:
>
>> Hi Andrey
>>
>> 2017-01-11 21:48 GMT+01:00 Andrey Andreev <narf@devilix.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.
>>
>> 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.

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


--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
Kalle Sommer Nielsen
Re: [PHP-DEV] Re: [Discussion] HKDF
January 12, 2017 12:10AM
Hi Niklas

2017-01-11 23:18 GMT+01:00 Niklas Keller <me@kelunik.com>:
> 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" <!-- EN-Revision: <svn revision> -->
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

--
PHP Internals - PHP Runtime Development Mailing List
To unsubscribe, visit: http://www.php.net/unsub.php
Joe Watkins
Re: [PHP-DEV] Re: [Discussion] HKDF
January 12, 2017 08:00AM
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 <kalle@php.net>
wrote:

> Hi Niklas
>
> 2017-01-11 23:18 GMT+01:00 Niklas Keller <me@kelunik.com>:
> > 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" <!-- EN-Revision: <svn revision> -->
> 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
>
> --
> PHP Internals - PHP Runtime Development Mailing List
> To unsubscribe, visit: http://www.php.net/unsub.php
>
>
Sorry, only registered users may post in this forum.

Click here to login