kafka-dev mailing list archives

Site index · List index
Message view « Date » · « Thread »
Top « Date » · « Thread »
From Paolo Patierno <ppatie...@live.com>
Subject Re: Kafka doc : official repo or web site repo ?
Date Fri, 21 Jul 2017 13:23:52 GMT
Hi Ewen,


thank you very much for your answer. I know that you guys are really busy and I pushed my
PRs during the 0.11.0 release cycle so ... I can understand, no worries ;)


Regarding the documentation happy to know that I pushed in the right repo but ...

... regarding the Kafka Streams new shiny documentation I see that the main page on the web
site has the following phrase on the top "The easiest way to write mission-critical ..."

If I try to search it in the Kafka repo I can't find it (I imagine that it should be in docs/streams/index.html
... but it's not there).

Instead, if I search for the same phrase in the kafka-site repo I can find it in 0110/streams/index.html.


So it seems that the doc is in the kafka-site repo but not in the kafka repo ... where am
I wrong ?


Thanks,

Paolo.


Paolo Patierno
Senior Software Engineer (IoT) @ Red Hat
Microsoft MVP on Windows Embedded & IoT
Microsoft Azure Advisor

Twitter : @ppatierno<http://twitter.com/ppatierno>
Linkedin : paolopatierno<http://it.linkedin.com/in/paolopatierno>
Blog : DevExperience<http://paolopatierno.wordpress.com/>


________________________________
From: Ewen Cheslack-Postava <ewen@confluent.io>
Sent: Friday, July 21, 2017 2:57 AM
To: dev@kafka.apache.org
Subject: Re: Kafka doc : official repo or web site repo ?

Hi Paolo,

Docs are a little bit confusing. Some of the docs are version-specific and
those live in the main repo and are managed by the same branches that
releases are managed on. Then there is the
https://github.com/apache/kafka-site which contains the actual contents of
the site. During release, the current snapshot of version-specific docs are
copied into the kafka-site repo (as the current version, or a historical
version as you would see at, e.g.,
http://kafka.apache.org/0102/documentation.html).

For your PR, you submitted to the correct location. Sorry for the delay in
review, we tend to get a little backlogged -- not enough committers to
review and commit the volume of PRs we are getting. I've reviewed and
committed that first one and I see you have a bunch of others that we'll
try to get to as well. Once you get a feel for which reviewers can/will
review different parts of the code, you'll be able to more easily tag
committers for review and commit (in the case of Connect, myself (@ewencp),
@hachikuji, and @gwenshap are good targets).

Thanks for contributing! I especially appreciate docs fixes :)

-Ewen

On Thu, Jul 13, 2017 at 1:51 AM, Paolo Patierno <ppatierno@live.com> wrote:

> Hi guys,
>
> I have big doubt on where is the doc and what to do for upgrading that.
>
> I see the docs folder in the Kafka repo (but even there I have a PR opened
> for one month on Kafka Connect not yet merged) but then I see the Kafka web
> site repo where there is the same doc.
>
> Reading the new Kafka Stream doc I noticed that it seems to be only in the
> Kafka web site repo and not in the Kafka repo.
>
>
> Can you clarifying me where to submit PRs for doc ? On which side ?
>
>
> Thanks,
>
>
> Paolo Patierno
> Senior Software Engineer (IoT) @ Red Hat
> Microsoft MVP on Windows Embedded & IoT
> Microsoft Azure Advisor
>
> Twitter : @ppatierno<http://twitter.com/ppatierno>
> Linkedin : paolopatierno<http://it.linkedin.com/in/paolopatierno>
> Blog : DevExperience<http://paolopatierno.wordpress.com/>
>

Mime
  • Unnamed multipart/alternative (inline, None, 0 bytes)
View raw message