[Feedhenry-raincatcher] Raincatcher Docs

[Don Naro]

Hey Paul,

Yep. Smaller PRs are better, easier to review. My first PR was intended to
be small enough and just take on one section. I think there were a few
rounds of review that might have been awkward, which I chalk up to just
getting acquainted with the project.

Most of all I want to avoid submitting a PR that turns into a review
nightmare. Or otherwise causing a bunch of disruption. I also don't want to
step on any toes or focus on the wrong things.

Anyway, it's a good suggestion to start with headings. I'll get into that
and we can see how it develops.

Will ping you later to set up a call.

Slan,
Don

On Wed, Oct 18, 2017 at 3:30 PM Paul Wright <pwright at redhat.com> wrote:

> Hi Don,
>
> I'm sure I speak for all when I say to start small, incremental changes
> are easier to create and manage.
>
> Let's start with headings , that would give you an overview, direction and
> allow us to dig into detail when necessary. Ping me with a time and I'll
> set up a call, not sure if we'll get an engineer to attend, but we'll get
> the ball rolling,
>
> thanks,
>
> Paul
>
> On 10/18/2017 03:09 PM, Don Naro wrote:
>
> Hi all,
>
> My name is Don Naro. I've recently forked the raincatcher-docs repo and
> would like to contribute to the content.
>
> In my opinion, the content could be made much more concise. I'd like to
> simplify and streamline some of the procedures. I also see some redundant
> information that we could remove.
>
> One of the other things I've noticed is that a lot of headings aren't
> quite so meaningful. As a user, I can't accurately derive the meaning of
> the content that follows a lot of the headings.
>
> I'd love to work on these docs some more. What's the best way to approach
> this?
>
> Should I start with a PR to suggest structural changes and then create
> additional PRs to rework the content? Would it be better if I just did
> everything in a single PR?
>
> Please let me know what you think would be best. I'm happy to contribute
> in any way.
>
> By the way, I wanted to confirm that I have been able to get the server,
> portal, and mobile apps running locally. I've also been able to build the
> website locally and build the asciidocs to review changes. It's really cool
> tech. I've enjoyed learning about it so far.
>
> Cheers,
> Don
>
>
> _______________________________________________
> Feedhenry-raincatcher mailing listFeedhenry-raincatcher at redhat.comhttps://www.redhat.com/mailman/listinfo/feedhenry-raincatcher
>
>
>
-------------- next part --------------
An HTML attachment was scrubbed...
URL: <http://listman.redhat.com/archives/feedhenry-raincatcher/attachments/20171018/e537a02f/attachment.htm>