Thread: Updated docs on base backups

Updated docs on base backups

From
Amir Rohan
Date:
Hi all,

See attached changed to current docs on subject. They have clearly
been reworked by multiple people piecemeal and had many issues
which made less than a joy to read, in fact they were damn frustrating
to read.

I've gone through the whole section and rewritten what needed to be.
I think the result is more cohesive, better explained, certainly
more accurate in some ways.

As imperfect as this may be, I think this version is significantly
better then what it replaces. It would be nice if someone had
the patience to read through and do what editing needs to be done,
as well as provide a technical sanity check.

There's a real dilemma facing a newcomer sitting down to rewrite
a portion of the manual -- you can't really consult the documentation to
make sure you've properly understood how the system works...

Amir


Attachment

Re: Updated docs on base backups

From
Amir Rohan
Date:
On 09/26/2015 12:02 PM, Amir Rohan wrote:
> Hi all,
>
> See attached changed to current docs on subject. They have clearly
> been reworked by multiple people piecemeal and had many issues
> which made less than a joy to read, in fact they were damn frustrating
> to read.

Updated version, with missing step for file system level backup
revised and added back.

Amir


Attachment

Re: Updated docs on base backups

From
Amir Rohan
Date:
On 09/26/2015 12:02 PM, Amir Rohan wrote:
> Hi all,
>
> See attached changed to current docs on subject. They have clearly
> been reworked by multiple people piecemeal and had many issues
> which made less than a joy to read, in fact they were damn frustrating
> to read.

Further editing. See attached V3.




Attachment

Re: Updated docs on base backups

From
Michael Paquier
Date:
On Sun, Sep 27, 2015 at 11:27 AM, Amir Rohan wrote:
> Further editing. See attached V3.

I think that you should consider adding this patch to the next commit
fest so as we do not lose track of it:
https://commitfest.postgresql.org/7/
--
Michael


Re: Updated docs on base backups

From
Amir Rohan
Date:
On 09/28/2015 06:33 AM, Michael Paquier wrote:
> On Sun, Sep 27, 2015 at 11:27 AM, Amir Rohan wrote:
>> Further editing. See attached V3.
>
> I think that you should consider adding this patch to the next commit
> fest so as we do not lose track of it:
> https://commitfest.postgresql.org/7/
>

https://commitfest.postgresql.org/7/379/