You are viewing a plain text version of this content. The canonical link for it is here.
Posted to user@mesos.apache.org by Dharmesh Kakadia <dh...@gmail.com> on 2015/03/01 10:53:45 UTC
Re: Orphan links in Docs
Hi Dave,
I have finally got some time to look at the regex you mentioned and indeed
thats what was the issue. I have fixed it but I don't know how to send
review request for the "site". I suppose "site" is not maintained in the
"repo". Can you please help me with that? Actual change is just one
character (:P), but I wanted to update the site README as well, as it would
make the process clearer for newbies like me.
Thanks,
Dharmesh
On Sat, Nov 15, 2014 at 11:23 PM, Dharmesh Kakadia <dh...@gmail.com>
wrote:
> Thanks Dave, Vinod and Adam. I will look into this. I will have to find
> some ruby before that :)
>
> Thanks,
> Dharmesh
>
> On Fri, Nov 14, 2014 at 2:20 AM, Adam Bordelon <ad...@mesosphere.io> wrote:
>
>> Here are some relevant JIRAs I found:
>> https://issues.apache.org/jira/browse/MESOS-934 - Mentions #1
>> https://issues.apache.org/jira/browse/MESOS-1521 - Mentions #2
>>
>> On Thu, Nov 13, 2014 at 12:22 PM, Dave Lester <da...@gmail.com>
>> wrote:
>>
>> > Contributions are welcome! The website is available on subversion
>> > https://svn.apache.org/repos/asf/mesos/site/, which ingests docs from
>> the
>> > /docs/ folder of the main code repo, and will render the markdown files
>> on
>> > the site. There's a README in that directory with some instructions for
>> > building the site.
>> >
>> > On #1 and #2, I believe this is an issue with the regex that generates
>> docs
>> > when renders on the website. Check out the website's Rakefile which
>> > includes some ruby code to parse links and remove the .md extensions
>> from
>> > them. I believe there are already JIRA issues tracking these issues.
>> >
>> > On #3, the files were not previously uploaded however I fixed that the
>> > other day.
>> >
>> > On Thu, Nov 13, 2014 at 12:16 PM, Vinod Kone <vi...@gmail.com>
>> wrote:
>> >
>> > > + Dave
>> > >
>> > > Dave, can you guide Dharmesh here?
>> > >
>> > > On Mon, Nov 10, 2014 at 7:50 AM, Dharmesh Kakadia <
>> dhkakadia@gmail.com>
>> > > wrote:
>> > >
>> > > > Hi,
>> > > >
>> > > > Following are dangling links in the documentation on Apache website.
>> > > >
>> > > > 1. Google blog link in
>> > > > http://mesos.apache.org/documentation/latest/logging-and-debugging/
>> > > > 2. High Availability link on
>> > > > http://mesos.apache.org/documentation/latest/deploy-scripts/.
>> > > > 3. Mesos Modules link on the documentation home.
>> > > >
>> > > > Also, there is no link from documentation home to reach to the
>> > > > deploy-scripts page. All of the links are rendered correctly on the
>> > > github,
>> > > > but not on the website. I would be happy to help, but I don’t quite
>> > > > understand what is the problem. Can anyone guide me?
>> > > >
>> > > > Also, Mesos-submit is no longer part of the Mesos. Should we remove
>> the
>> > > > mesos-submit from the docs? I see a few pending PR for docs that
>> just
>> > > > require rebasing. I can take a shot at that too, if thats fine with
>> > > > everyone.
>> > > >
>> > > > Lets make docs as good as Mesos :)
>> > > >
>> > > > Thanks,
>> > > > Dharmesh
>> > > >
>> > > >
>> > >
>> >
>>
>
>
Fwd: Orphan links in Docs
Posted by Dharmesh Kakadia <dh...@gmail.com>.
Hey Dave,
Would you be able to review this ?
Thanks,
Dharmesh
---------- Forwarded message ----------
From: Dharmesh Kakadia <dh...@gmail.com>
Date: Mon, Mar 2, 2015 at 9:35 PM
Subject: Re: Orphan links in Docs
To: dev <de...@mesos.apache.org>
Thanks Dave !!
I have attached the patch on
https://issues.apache.org/jira/browse/MESOS-1521
(BTW this also corrects : https://issues.apache.org/jira/browse/MESOS-2004)
I have one more question regarding how images are committed in site? I see
https://issues.apache.org/jira/browse/MESOS-2220 and the patch there will
not solve the problem. We have to pull new images from github images
folder. Should I just send a diff of images or its pulled by script
somewhere ? I am not familiar with middleman-blog but can give it a try if
I understand what needs to be done.
Also, I sent some other PRs on github for docs.
Thanks,
Dharmesh
On Mon, Mar 2, 2015 at 1:16 PM, Dave Lester <da...@davelester.org> wrote:
> Hi Dharmesh,
>
> Sounds great, thanks for taking a closer look! Can you attach your patch
> to one of the JIRA issues below and pass along the link? I can help
> review it and see that it's committed.
>
> Thanks!
> Dave
>
> On Sun, Mar 1, 2015, at 01:53 AM, Dharmesh Kakadia wrote:
> > Hi Dave,
> >
> > I have finally got some time to look at the regex you mentioned and
> > indeed
> > thats what was the issue. I have fixed it but I don't know how to send
> > review request for the "site". I suppose "site" is not maintained in the
> > "repo". Can you please help me with that? Actual change is just one
> > character (:P), but I wanted to update the site README as well, as it
> > would
> > make the process clearer for newbies like me.
> >
> > Thanks,
> > Dharmesh
> >
> > On Sat, Nov 15, 2014 at 11:23 PM, Dharmesh Kakadia <dh...@gmail.com>
> > wrote:
> >
> > > Thanks Dave, Vinod and Adam. I will look into this. I will have to find
> > > some ruby before that :)
> > >
> > > Thanks,
> > > Dharmesh
> > >
> > > On Fri, Nov 14, 2014 at 2:20 AM, Adam Bordelon <ad...@mesosphere.io>
> wrote:
> > >
> > >> Here are some relevant JIRAs I found:
> > >> https://issues.apache.org/jira/browse/MESOS-934 - Mentions #1
> > >> https://issues.apache.org/jira/browse/MESOS-1521 - Mentions #2
> > >>
> > >> On Thu, Nov 13, 2014 at 12:22 PM, Dave Lester <da...@gmail.com>
> > >> wrote:
> > >>
> > >> > Contributions are welcome! The website is available on subversion
> > >> > https://svn.apache.org/repos/asf/mesos/site/, which ingests docs
> from
> > >> the
> > >> > /docs/ folder of the main code repo, and will render the markdown
> files
> > >> on
> > >> > the site. There's a README in that directory with some instructions
> for
> > >> > building the site.
> > >> >
> > >> > On #1 and #2, I believe this is an issue with the regex that
> generates
> > >> docs
> > >> > when renders on the website. Check out the website's Rakefile which
> > >> > includes some ruby code to parse links and remove the .md extensions
> > >> from
> > >> > them. I believe there are already JIRA issues tracking these issues.
> > >> >
> > >> > On #3, the files were not previously uploaded however I fixed that
> the
> > >> > other day.
> > >> >
> > >> > On Thu, Nov 13, 2014 at 12:16 PM, Vinod Kone <vi...@gmail.com>
> > >> wrote:
> > >> >
> > >> > > + Dave
> > >> > >
> > >> > > Dave, can you guide Dharmesh here?
> > >> > >
> > >> > > On Mon, Nov 10, 2014 at 7:50 AM, Dharmesh Kakadia <
> > >> dhkakadia@gmail.com>
> > >> > > wrote:
> > >> > >
> > >> > > > Hi,
> > >> > > >
> > >> > > > Following are dangling links in the documentation on Apache
> website.
> > >> > > >
> > >> > > > 1. Google blog link in
> > >> > > >
> http://mesos.apache.org/documentation/latest/logging-and-debugging/
> > >> > > > 2. High Availability link on
> > >> > > > http://mesos.apache.org/documentation/latest/deploy-scripts/.
> > >> > > > 3. Mesos Modules link on the documentation home.
> > >> > > >
> > >> > > > Also, there is no link from documentation home to reach to the
> > >> > > > deploy-scripts page. All of the links are rendered correctly on
> the
> > >> > > github,
> > >> > > > but not on the website. I would be happy to help, but I don’t
> quite
> > >> > > > understand what is the problem. Can anyone guide me?
> > >> > > >
> > >> > > > Also, Mesos-submit is no longer part of the Mesos. Should we
> remove
> > >> the
> > >> > > > mesos-submit from the docs? I see a few pending PR for docs that
> > >> just
> > >> > > > require rebasing. I can take a shot at that too, if thats fine
> with
> > >> > > > everyone.
> > >> > > >
> > >> > > > Lets make docs as good as Mesos :)
> > >> > > >
> > >> > > > Thanks,
> > >> > > > Dharmesh
> > >> > > >
> > >> > > >
> > >> > >
> > >> >
> > >>
> > >
> > >
>
Fwd: Orphan links in Docs
Posted by Dharmesh Kakadia <dh...@gmail.com>.
Hey Dave,
Would you be able to review this ?
Thanks,
Dharmesh
---------- Forwarded message ----------
From: Dharmesh Kakadia <dh...@gmail.com>
Date: Mon, Mar 2, 2015 at 9:35 PM
Subject: Re: Orphan links in Docs
To: dev <de...@mesos.apache.org>
Thanks Dave !!
I have attached the patch on
https://issues.apache.org/jira/browse/MESOS-1521
(BTW this also corrects : https://issues.apache.org/jira/browse/MESOS-2004)
I have one more question regarding how images are committed in site? I see
https://issues.apache.org/jira/browse/MESOS-2220 and the patch there will
not solve the problem. We have to pull new images from github images
folder. Should I just send a diff of images or its pulled by script
somewhere ? I am not familiar with middleman-blog but can give it a try if
I understand what needs to be done.
Also, I sent some other PRs on github for docs.
Thanks,
Dharmesh
On Mon, Mar 2, 2015 at 1:16 PM, Dave Lester <da...@davelester.org> wrote:
> Hi Dharmesh,
>
> Sounds great, thanks for taking a closer look! Can you attach your patch
> to one of the JIRA issues below and pass along the link? I can help
> review it and see that it's committed.
>
> Thanks!
> Dave
>
> On Sun, Mar 1, 2015, at 01:53 AM, Dharmesh Kakadia wrote:
> > Hi Dave,
> >
> > I have finally got some time to look at the regex you mentioned and
> > indeed
> > thats what was the issue. I have fixed it but I don't know how to send
> > review request for the "site". I suppose "site" is not maintained in the
> > "repo". Can you please help me with that? Actual change is just one
> > character (:P), but I wanted to update the site README as well, as it
> > would
> > make the process clearer for newbies like me.
> >
> > Thanks,
> > Dharmesh
> >
> > On Sat, Nov 15, 2014 at 11:23 PM, Dharmesh Kakadia <dh...@gmail.com>
> > wrote:
> >
> > > Thanks Dave, Vinod and Adam. I will look into this. I will have to find
> > > some ruby before that :)
> > >
> > > Thanks,
> > > Dharmesh
> > >
> > > On Fri, Nov 14, 2014 at 2:20 AM, Adam Bordelon <ad...@mesosphere.io>
> wrote:
> > >
> > >> Here are some relevant JIRAs I found:
> > >> https://issues.apache.org/jira/browse/MESOS-934 - Mentions #1
> > >> https://issues.apache.org/jira/browse/MESOS-1521 - Mentions #2
> > >>
> > >> On Thu, Nov 13, 2014 at 12:22 PM, Dave Lester <da...@gmail.com>
> > >> wrote:
> > >>
> > >> > Contributions are welcome! The website is available on subversion
> > >> > https://svn.apache.org/repos/asf/mesos/site/, which ingests docs
> from
> > >> the
> > >> > /docs/ folder of the main code repo, and will render the markdown
> files
> > >> on
> > >> > the site. There's a README in that directory with some instructions
> for
> > >> > building the site.
> > >> >
> > >> > On #1 and #2, I believe this is an issue with the regex that
> generates
> > >> docs
> > >> > when renders on the website. Check out the website's Rakefile which
> > >> > includes some ruby code to parse links and remove the .md extensions
> > >> from
> > >> > them. I believe there are already JIRA issues tracking these issues.
> > >> >
> > >> > On #3, the files were not previously uploaded however I fixed that
> the
> > >> > other day.
> > >> >
> > >> > On Thu, Nov 13, 2014 at 12:16 PM, Vinod Kone <vi...@gmail.com>
> > >> wrote:
> > >> >
> > >> > > + Dave
> > >> > >
> > >> > > Dave, can you guide Dharmesh here?
> > >> > >
> > >> > > On Mon, Nov 10, 2014 at 7:50 AM, Dharmesh Kakadia <
> > >> dhkakadia@gmail.com>
> > >> > > wrote:
> > >> > >
> > >> > > > Hi,
> > >> > > >
> > >> > > > Following are dangling links in the documentation on Apache
> website.
> > >> > > >
> > >> > > > 1. Google blog link in
> > >> > > >
> http://mesos.apache.org/documentation/latest/logging-and-debugging/
> > >> > > > 2. High Availability link on
> > >> > > > http://mesos.apache.org/documentation/latest/deploy-scripts/.
> > >> > > > 3. Mesos Modules link on the documentation home.
> > >> > > >
> > >> > > > Also, there is no link from documentation home to reach to the
> > >> > > > deploy-scripts page. All of the links are rendered correctly on
> the
> > >> > > github,
> > >> > > > but not on the website. I would be happy to help, but I don’t
> quite
> > >> > > > understand what is the problem. Can anyone guide me?
> > >> > > >
> > >> > > > Also, Mesos-submit is no longer part of the Mesos. Should we
> remove
> > >> the
> > >> > > > mesos-submit from the docs? I see a few pending PR for docs that
> > >> just
> > >> > > > require rebasing. I can take a shot at that too, if thats fine
> with
> > >> > > > everyone.
> > >> > > >
> > >> > > > Lets make docs as good as Mesos :)
> > >> > > >
> > >> > > > Thanks,
> > >> > > > Dharmesh
> > >> > > >
> > >> > > >
> > >> > >
> > >> >
> > >>
> > >
> > >
>
Re: Orphan links in Docs
Posted by Dharmesh Kakadia <dh...@gmail.com>.
Thanks Dave !!
I have attached the patch on
https://issues.apache.org/jira/browse/MESOS-1521
(BTW this also corrects : https://issues.apache.org/jira/browse/MESOS-2004)
I have one more question regarding how images are committed in site? I see
https://issues.apache.org/jira/browse/MESOS-2220 and the patch there will
not solve the problem. We have to pull new images from github images
folder. Should I just send a diff of images or its pulled by script
somewhere ? I am not familiar with middleman-blog but can give it a try if
I understand what needs to be done.
Also, I sent some other PRs on github for docs.
Thanks,
Dharmesh
On Mon, Mar 2, 2015 at 1:16 PM, Dave Lester <da...@davelester.org> wrote:
> Hi Dharmesh,
>
> Sounds great, thanks for taking a closer look! Can you attach your patch
> to one of the JIRA issues below and pass along the link? I can help
> review it and see that it's committed.
>
> Thanks!
> Dave
>
> On Sun, Mar 1, 2015, at 01:53 AM, Dharmesh Kakadia wrote:
> > Hi Dave,
> >
> > I have finally got some time to look at the regex you mentioned and
> > indeed
> > thats what was the issue. I have fixed it but I don't know how to send
> > review request for the "site". I suppose "site" is not maintained in the
> > "repo". Can you please help me with that? Actual change is just one
> > character (:P), but I wanted to update the site README as well, as it
> > would
> > make the process clearer for newbies like me.
> >
> > Thanks,
> > Dharmesh
> >
> > On Sat, Nov 15, 2014 at 11:23 PM, Dharmesh Kakadia <dh...@gmail.com>
> > wrote:
> >
> > > Thanks Dave, Vinod and Adam. I will look into this. I will have to find
> > > some ruby before that :)
> > >
> > > Thanks,
> > > Dharmesh
> > >
> > > On Fri, Nov 14, 2014 at 2:20 AM, Adam Bordelon <ad...@mesosphere.io>
> wrote:
> > >
> > >> Here are some relevant JIRAs I found:
> > >> https://issues.apache.org/jira/browse/MESOS-934 - Mentions #1
> > >> https://issues.apache.org/jira/browse/MESOS-1521 - Mentions #2
> > >>
> > >> On Thu, Nov 13, 2014 at 12:22 PM, Dave Lester <da...@gmail.com>
> > >> wrote:
> > >>
> > >> > Contributions are welcome! The website is available on subversion
> > >> > https://svn.apache.org/repos/asf/mesos/site/, which ingests docs
> from
> > >> the
> > >> > /docs/ folder of the main code repo, and will render the markdown
> files
> > >> on
> > >> > the site. There's a README in that directory with some instructions
> for
> > >> > building the site.
> > >> >
> > >> > On #1 and #2, I believe this is an issue with the regex that
> generates
> > >> docs
> > >> > when renders on the website. Check out the website's Rakefile which
> > >> > includes some ruby code to parse links and remove the .md extensions
> > >> from
> > >> > them. I believe there are already JIRA issues tracking these issues.
> > >> >
> > >> > On #3, the files were not previously uploaded however I fixed that
> the
> > >> > other day.
> > >> >
> > >> > On Thu, Nov 13, 2014 at 12:16 PM, Vinod Kone <vi...@gmail.com>
> > >> wrote:
> > >> >
> > >> > > + Dave
> > >> > >
> > >> > > Dave, can you guide Dharmesh here?
> > >> > >
> > >> > > On Mon, Nov 10, 2014 at 7:50 AM, Dharmesh Kakadia <
> > >> dhkakadia@gmail.com>
> > >> > > wrote:
> > >> > >
> > >> > > > Hi,
> > >> > > >
> > >> > > > Following are dangling links in the documentation on Apache
> website.
> > >> > > >
> > >> > > > 1. Google blog link in
> > >> > > >
> http://mesos.apache.org/documentation/latest/logging-and-debugging/
> > >> > > > 2. High Availability link on
> > >> > > > http://mesos.apache.org/documentation/latest/deploy-scripts/.
> > >> > > > 3. Mesos Modules link on the documentation home.
> > >> > > >
> > >> > > > Also, there is no link from documentation home to reach to the
> > >> > > > deploy-scripts page. All of the links are rendered correctly on
> the
> > >> > > github,
> > >> > > > but not on the website. I would be happy to help, but I don’t
> quite
> > >> > > > understand what is the problem. Can anyone guide me?
> > >> > > >
> > >> > > > Also, Mesos-submit is no longer part of the Mesos. Should we
> remove
> > >> the
> > >> > > > mesos-submit from the docs? I see a few pending PR for docs that
> > >> just
> > >> > > > require rebasing. I can take a shot at that too, if thats fine
> with
> > >> > > > everyone.
> > >> > > >
> > >> > > > Lets make docs as good as Mesos :)
> > >> > > >
> > >> > > > Thanks,
> > >> > > > Dharmesh
> > >> > > >
> > >> > > >
> > >> > >
> > >> >
> > >>
> > >
> > >
>
Re: Orphan links in Docs
Posted by Dave Lester <da...@davelester.org>.
Hi Dharmesh,
Sounds great, thanks for taking a closer look! Can you attach your patch
to one of the JIRA issues below and pass along the link? I can help
review it and see that it's committed.
Thanks!
Dave
On Sun, Mar 1, 2015, at 01:53 AM, Dharmesh Kakadia wrote:
> Hi Dave,
>
> I have finally got some time to look at the regex you mentioned and
> indeed
> thats what was the issue. I have fixed it but I don't know how to send
> review request for the "site". I suppose "site" is not maintained in the
> "repo". Can you please help me with that? Actual change is just one
> character (:P), but I wanted to update the site README as well, as it
> would
> make the process clearer for newbies like me.
>
> Thanks,
> Dharmesh
>
> On Sat, Nov 15, 2014 at 11:23 PM, Dharmesh Kakadia <dh...@gmail.com>
> wrote:
>
> > Thanks Dave, Vinod and Adam. I will look into this. I will have to find
> > some ruby before that :)
> >
> > Thanks,
> > Dharmesh
> >
> > On Fri, Nov 14, 2014 at 2:20 AM, Adam Bordelon <ad...@mesosphere.io> wrote:
> >
> >> Here are some relevant JIRAs I found:
> >> https://issues.apache.org/jira/browse/MESOS-934 - Mentions #1
> >> https://issues.apache.org/jira/browse/MESOS-1521 - Mentions #2
> >>
> >> On Thu, Nov 13, 2014 at 12:22 PM, Dave Lester <da...@gmail.com>
> >> wrote:
> >>
> >> > Contributions are welcome! The website is available on subversion
> >> > https://svn.apache.org/repos/asf/mesos/site/, which ingests docs from
> >> the
> >> > /docs/ folder of the main code repo, and will render the markdown files
> >> on
> >> > the site. There's a README in that directory with some instructions for
> >> > building the site.
> >> >
> >> > On #1 and #2, I believe this is an issue with the regex that generates
> >> docs
> >> > when renders on the website. Check out the website's Rakefile which
> >> > includes some ruby code to parse links and remove the .md extensions
> >> from
> >> > them. I believe there are already JIRA issues tracking these issues.
> >> >
> >> > On #3, the files were not previously uploaded however I fixed that the
> >> > other day.
> >> >
> >> > On Thu, Nov 13, 2014 at 12:16 PM, Vinod Kone <vi...@gmail.com>
> >> wrote:
> >> >
> >> > > + Dave
> >> > >
> >> > > Dave, can you guide Dharmesh here?
> >> > >
> >> > > On Mon, Nov 10, 2014 at 7:50 AM, Dharmesh Kakadia <
> >> dhkakadia@gmail.com>
> >> > > wrote:
> >> > >
> >> > > > Hi,
> >> > > >
> >> > > > Following are dangling links in the documentation on Apache website.
> >> > > >
> >> > > > 1. Google blog link in
> >> > > > http://mesos.apache.org/documentation/latest/logging-and-debugging/
> >> > > > 2. High Availability link on
> >> > > > http://mesos.apache.org/documentation/latest/deploy-scripts/.
> >> > > > 3. Mesos Modules link on the documentation home.
> >> > > >
> >> > > > Also, there is no link from documentation home to reach to the
> >> > > > deploy-scripts page. All of the links are rendered correctly on the
> >> > > github,
> >> > > > but not on the website. I would be happy to help, but I don’t quite
> >> > > > understand what is the problem. Can anyone guide me?
> >> > > >
> >> > > > Also, Mesos-submit is no longer part of the Mesos. Should we remove
> >> the
> >> > > > mesos-submit from the docs? I see a few pending PR for docs that
> >> just
> >> > > > require rebasing. I can take a shot at that too, if thats fine with
> >> > > > everyone.
> >> > > >
> >> > > > Lets make docs as good as Mesos :)
> >> > > >
> >> > > > Thanks,
> >> > > > Dharmesh
> >> > > >
> >> > > >
> >> > >
> >> >
> >>
> >
> >