Move changelog to a folder and use single file entries

[wilzbach]

Single files allow to enforce that every PR comes with a changelog as one can't run into a merge conflicts.

For DMD the idea was to move the language changelog directly to dlang.org, s.t. the DMD repo only contains the compiler changes.

For more details, see dlang/tools#186

[WalterBright]

I'll defer this to @MartinNowak

[nemanja-boric-sociomantic]

I'm just trying to add the changelog for druntime PR and I find this very confusing. Is what follows the content of the file? If so, what's the name of the file? Maybe add more documentation around here.

[wilzbach]

I find this very confusing

Please see dlang/phobos#4228 for the motivation and examples.

Is what follows the content of the file?

Yes.

If so, what's the name of the file?

There's no fixed file name scheme except that the extension should be .dd (Ddoc extension).

Maybe add more documentation around here.

Ok - Will do so later.

[nemanja-boric-sociomantic]

Please see dlang/phobos#4228 for the motivation and examples.

Sorry, the intention was not confusing, but more how should I use it :-). As being one that wasn't involved in the motivation/examples, I just wanted to say that the README is confusing as it doesn't provide clear guidelines what one should do (and there's no prior art in the same repo to rip it off)

[nemanja-boric-sociomantic]

This doesn't seems to work with freshly copied dlang/tools repository:

nemanjaboric@labs-129:/home/nemanjaboric/work/druntime  git:(fiber-protection*) $ ../tools/changed.d -o ../dlang.org/changelog/pending.dd && make -C ../dlang.org -f posix.mak html
Usage: ./changed <revision range>, e.g. ./changed v2.067.1..upstream/stable

[wilzbach]

Yep the downsides of having many repos - PR is still pending: dlang/tools#186

[nemanja-boric-sociomantic]

Ah, ok then 👍

[wilzbach]

I just wanted to say that the README is confusing as it doesn't provide clear guidelines what one should do (and there's no prior art in the same repo to rip it off)

The initial version was a lot more strict and then people demanded to make it more lax :P
I tried to reformulate the example, s.t. it shows more what one can do with ddoc and I guess once there "is more prior art" it should even be more intuitive.