Re: Documentation questions from a newcomer

2021-05-09 Thread Karen Lease
Hi Camel developers, I've committed the refactoring of the community pages in the Camel website (see CAMEL-16576 in JIRA) and created 2 pull requests, one for the main camel repository and one for the camel-website repository. Many thanks to Zoran for his support & advice. Hopefully, I've man

Re: Documentation questions from a newcomer

2021-05-06 Thread Karen Lease
Hi Zoran, On 06/05/2021 07:31, Zoran Regvart wrote: Hi Karen, replying to two emails with one :) ... This is a very interesting approach, and I do like it, we get to maintain one copy, which I really like. I wonder, though, we have several contribution documents, one per subproject (see below)

Re: Documentation questions from a newcomer

2021-05-05 Thread Zoran Regvart
Hi Karen, replying to two emails with one :) On Wed, May 5, 2021 at 7:41 PM Karen Lease wrote: > Footnotes in a mail--I'm impressed! Thanks again for the excellent > mentoring. :) thank you for taking the time to discuss changes, and being very thorough! > Everything is clear except the contrib

Fwd: Documentation questions from a newcomer

2021-05-05 Thread Karen Lease
Hi Zoran (and all) In my previous mail I wrote: >>The ideal would perhaps be to include the CONTRIBUTING.md automatically in the website when it's built, but I haven't delved into the generator tools enough to know if that's doable. Also there would be some differences with links, since the o

Re: Documentation questions from a newcomer

2021-05-05 Thread Karen Lease
Hi Zoran, Footnotes in a mail--I'm impressed! Thanks again for the excellent mentoring. Everything is clear except the contributing.md which is still a bit fuzzy for me. I now understand why there should be a CONTRIBUTING.md at the root of the repository, but when you say "and just point t

Re: Documentation questions from a newcomer

2021-05-05 Thread Zoran Regvart
Hi Karen, On Tue, May 4, 2021 at 5:13 PM Karen Lease wrote: > I've made the changes as discussed below and pushed them to my forked > repositories for camel & camel-website (https://github.com/klease/camel > & https://github.com/klease/camel-website/). The changes from the main > repo are also me

Re: Documentation questions from a newcomer

2021-05-04 Thread Karen Lease
Hi Zoran, Thanks for the approval & useful feedback. I've made the changes as discussed below and pushed them to my forked repositories for camel & camel-website (https://github.com/klease/camel & https://github.com/klease/camel-website/). The changes from the main repo are also merged & push

Re: Documentation questions from a newcomer

2021-04-29 Thread Zoran Regvart
Hi Karen, thank you for doing the analysis and for the very thoughtful plan. Replies are inline. On Wed, Apr 28, 2021 at 11:56 AM Karen Lease wrote: [snip] > 1. Compare & merge more recent changes from adoc files to md files and > remove the .adoc files. +1, I prefer the manual to be focused on

Re: Documentation questions from a newcomer

2021-04-28 Thread Karen Lease
Hi Zoran, Thanks for your explanations about the editing process and the reason for the duplicated adoc & md files. I found that besides the user-stories files, there are a few other files referenced in Community which are also duplicated. There are also some slight inconsistencies in the li

Re: Documentation questions from a newcomer

2021-04-27 Thread Zoran Regvart
Hi Karen, thanks for taking interest in our project and especially around the documentation! Some answers inline. On Mon, Apr 26, 2021 at 10:54 PM Karen Lease wrote: > > Thanks for the reply. > > In fact, when I click the "Edit this page" link, it takes me to the git > repository page with this m

Re: Documentation questions from a newcomer

2021-04-26 Thread Karen Lease
Thanks for the reply. In fact, when I click the "Edit this page" link, it takes me to the git repository page with this message: "You need to fork this repository to propose changes. Sorry, you’re not able to edit this repository directly—you need to fork it and propose your changes from ther

Re: Documentation questions from a newcomer

2021-04-26 Thread Andrea
Welcome! answers inline: On Mon, Apr 26, 2021, at 11:26, Karen Lease wrote: > Hello Camel developers, > > I'm Karen Lease & I'm interested in contributing to your project. Many > years ago I was a committer on FOP but stopped due to my professional > workload. For my job I had developed a smal

Documentation questions from a newcomer

2021-04-26 Thread Karen Lease
Hello Camel developers, I'm Karen Lease & I'm interested in contributing to your project. Many years ago I was a committer on FOP but stopped due to my professional workload. For my job I had developed a small "pipeline" project to chain together various processes such as XSLT & FOP specified