Re: [DISCUSS] Website
The repo's been created: https://git-wip-us.apache.org/repos/asf/incubator-ariatosca-website.git Access it using the normal means. John On Tue, Jan 10, 2017 at 11:33 AM Arthur Berezinwrote: > Sounds good. Thanks. > > On Tue, Jan 10, 2017 at 6:31 PM John D. Ament > wrote: > > > Ok, I'll get the reporeq in. I'll call it "incubator-ariatosca-website" > > > > John > > > > On Tue, Jan 10, 2017 at 11:23 AM Arthur Berezin > > wrote: > > > > > Thanks, John. > > > > > > Let's first create a dedicated repo for the website and start from > there. > > > > > > Arthur > > > > > > On Mon, Jan 9, 2017 at 4:02 PM John D. Ament > > > wrote: > > > > > > > Arthur, > > > > > > > > There's some basic docs up on http://apache.org/dev/#web > > > > It lists CMS as the preferred approach. CMS isn't the preferred any > > > > longer, so this needs some updating. > > > > > > > > The recommendation is to use a dedicated git repo for the website > code. > > > > Once that's in, you would setup a jenkins job that clones the repo, > > > builds > > > > the site, and then pushes to asf-site. > > > > > > > > There's a template for a shell script that does this here: > > > > > > > > > > > > > > http://svn.apache.org/viewvc/incubator/public/trunk/build_site.sh?revision=1776892=markup > > > > > > > > We should be able to keep the discussions on this list, we can raise > > > infra > > > > tickets as needed. > > > > > > > > John > > > > > > > > On Mon, Jan 9, 2017 at 7:50 AM Arthur Berezin > > > > > wrote: > > > > > > > > > John, Suneel, We would like to migrate the website to Jekyll, > where > > > can > > > > I > > > > > find more information on what servers the web pages from the ASF > > repos? > > > > Is > > > > > there anyone that could help with the migration process, setting up > > > > needed > > > > > asf infrastructure? > > > > > > > > > > > > > > > On Mon, Dec 5, 2016 at 2:39 PM Arthur Berezin < > art...@gigaspaces.com > > > > > > > > wrote: > > > > > > > > > > > Hi All, > > > > > > I would like to follow up on this, and pick up the ball for > > updating > > > > > > ARIA's website according to ASF guidelines. > > > > > > > > > > > > [comments inline] > > > > > > > > > > > > On Mon, Nov 14, 2016 at 4:43 PM John D. Ament < > > johndam...@apache.org > > > > > > > > > > wrote: > > > > > > > > > > > > All, > > > > > > > > > > > > AriaTosca has been incubating since August and still does not > have > > a > > > > > > website. IMHO this is a potential problem, especially around > > > community > > > > > > building. > > > > > > > > > > > > > > > > > > One idea may be to use the newly crafted Apache Website Template > to > > > > build > > > > > > the website. You can see the template here: > > > > > > https://github.com/apache/apache-website-template - its based on > > > > jekyll. > > > > > > > > > > > > The flipside, there's already http://ariatosca.org/ which I'm > > > assuming > > > > > is > > > > > > this podling. It may make sense for this website to become our > > > > website, > > > > > > focused on the underlying Apache community. > > > > > > > > > > > > > > > > > > You are correct, www.ariatosca.org is the website we brought up > > for > > > > the > > > > > > ARIA TOSCA Podling,it was brought up before it was accepted as an > > asf > > > > > > Incubator project. I would like to make sure we are compliant > with > > > ASF > > > > > > process as well, and we have all needed information there. > > > > > > > > > > > > Can we use this this as a starting point, add the missing > > information > > > > > > expected to be there? > > > > > > I've highlighted the gaps we should complete, based on the the > > > Podling > > > > > > webisite guildeline: > > > > > > http://incubator.apache.org/guides/sites.html > > > > > > > > > > > > > > > > > >- Project Home Page: the primary entry point to the site; > > contains > > > > > >project description, news, invitation to join the project. > > > > > >- License Page: usually, the Apache License 2.0 > > > > > >- Downloads: many projects in incubation will release code, > and > > > this > > > > > >page describes them and has links to the download pages that > > > > redirect > > > > > to > > > > > >Apache Mirror sites. > > > > > >- Documentation: this page describes the project > documentation, > > > > > >including javadoc for Java projects; guides, tutorials, and > > links > > > to > > > > > >external documentation. > > > > > >- *Committers: *a list of current committers on the project. > > > > > >- *Mailing Lists:* there are several mailing lists that the > > > > community > > > > > >might be interested in, and this page contains mailto: links > > that > > > > > >allow easy subscription (and unsubscription) to any of them. > > > > > >- *FAQ: *frequently asked questions are answered here. > > > > > >- Road Map: if the project
Re: [DISCUSS] Website
Sounds good. Thanks. On Tue, Jan 10, 2017 at 6:31 PM John D. Amentwrote: > Ok, I'll get the reporeq in. I'll call it "incubator-ariatosca-website" > > John > > On Tue, Jan 10, 2017 at 11:23 AM Arthur Berezin > wrote: > > > Thanks, John. > > > > Let's first create a dedicated repo for the website and start from there. > > > > Arthur > > > > On Mon, Jan 9, 2017 at 4:02 PM John D. Ament > > wrote: > > > > > Arthur, > > > > > > There's some basic docs up on http://apache.org/dev/#web > > > It lists CMS as the preferred approach. CMS isn't the preferred any > > > longer, so this needs some updating. > > > > > > The recommendation is to use a dedicated git repo for the website code. > > > Once that's in, you would setup a jenkins job that clones the repo, > > builds > > > the site, and then pushes to asf-site. > > > > > > There's a template for a shell script that does this here: > > > > > > > > > http://svn.apache.org/viewvc/incubator/public/trunk/build_site.sh?revision=1776892=markup > > > > > > We should be able to keep the discussions on this list, we can raise > > infra > > > tickets as needed. > > > > > > John > > > > > > On Mon, Jan 9, 2017 at 7:50 AM Arthur Berezin > > > wrote: > > > > > > > John, Suneel, We would like to migrate the website to Jekyll, where > > can > > > I > > > > find more information on what servers the web pages from the ASF > repos? > > > Is > > > > there anyone that could help with the migration process, setting up > > > needed > > > > asf infrastructure? > > > > > > > > > > > > On Mon, Dec 5, 2016 at 2:39 PM Arthur Berezin > > > > > wrote: > > > > > > > > > Hi All, > > > > > I would like to follow up on this, and pick up the ball for > updating > > > > > ARIA's website according to ASF guidelines. > > > > > > > > > > [comments inline] > > > > > > > > > > On Mon, Nov 14, 2016 at 4:43 PM John D. Ament < > johndam...@apache.org > > > > > > > > wrote: > > > > > > > > > > All, > > > > > > > > > > AriaTosca has been incubating since August and still does not have > a > > > > > website. IMHO this is a potential problem, especially around > > community > > > > > building. > > > > > > > > > > > > > > > One idea may be to use the newly crafted Apache Website Template to > > > build > > > > > the website. You can see the template here: > > > > > https://github.com/apache/apache-website-template - its based on > > > jekyll. > > > > > > > > > > The flipside, there's already http://ariatosca.org/ which I'm > > assuming > > > > is > > > > > this podling. It may make sense for this website to become our > > > website, > > > > > focused on the underlying Apache community. > > > > > > > > > > > > > > > You are correct, www.ariatosca.org is the website we brought up > for > > > the > > > > > ARIA TOSCA Podling,it was brought up before it was accepted as an > asf > > > > > Incubator project. I would like to make sure we are compliant with > > ASF > > > > > process as well, and we have all needed information there. > > > > > > > > > > Can we use this this as a starting point, add the missing > information > > > > > expected to be there? > > > > > I've highlighted the gaps we should complete, based on the the > > Podling > > > > > webisite guildeline: > > > > > http://incubator.apache.org/guides/sites.html > > > > > > > > > > > > > > >- Project Home Page: the primary entry point to the site; > contains > > > > >project description, news, invitation to join the project. > > > > >- License Page: usually, the Apache License 2.0 > > > > >- Downloads: many projects in incubation will release code, and > > this > > > > >page describes them and has links to the download pages that > > > redirect > > > > to > > > > >Apache Mirror sites. > > > > >- Documentation: this page describes the project documentation, > > > > >including javadoc for Java projects; guides, tutorials, and > links > > to > > > > >external documentation. > > > > >- *Committers: *a list of current committers on the project. > > > > >- *Mailing Lists:* there are several mailing lists that the > > > community > > > > >might be interested in, and this page contains mailto: links > that > > > > >allow easy subscription (and unsubscription) to any of them. > > > > >- *FAQ: *frequently asked questions are answered here. > > > > >- Road Map: if the project has a vision of future community or > > > > >development activities, the road map is published here. > > > > >- *Source Code: *links to the browsable source repository and > svn > > > > >commands to check out the sources. > > > > >- Coding Standards: the coding standards for submitted code by > the > > > > >community, along with a description of how strict the project > > > intends > > > > to be. > > > > >- *Issue Tracking: *links to the JIRA or other issue tracking > > tool, > > > > >
Re: [DISCUSS] Website
Thanks, John. Let's first create a dedicated repo for the website and start from there. Arthur On Mon, Jan 9, 2017 at 4:02 PM John D. Amentwrote: > Arthur, > > There's some basic docs up on http://apache.org/dev/#web > It lists CMS as the preferred approach. CMS isn't the preferred any > longer, so this needs some updating. > > The recommendation is to use a dedicated git repo for the website code. > Once that's in, you would setup a jenkins job that clones the repo, builds > the site, and then pushes to asf-site. > > There's a template for a shell script that does this here: > > http://svn.apache.org/viewvc/incubator/public/trunk/build_site.sh?revision=1776892=markup > > We should be able to keep the discussions on this list, we can raise infra > tickets as needed. > > John > > On Mon, Jan 9, 2017 at 7:50 AM Arthur Berezin > wrote: > > > John, Suneel, We would like to migrate the website to Jekyll, where can > I > > find more information on what servers the web pages from the ASF repos? > Is > > there anyone that could help with the migration process, setting up > needed > > asf infrastructure? > > > > > > On Mon, Dec 5, 2016 at 2:39 PM Arthur Berezin > > wrote: > > > > > Hi All, > > > I would like to follow up on this, and pick up the ball for updating > > > ARIA's website according to ASF guidelines. > > > > > > [comments inline] > > > > > > On Mon, Nov 14, 2016 at 4:43 PM John D. Ament > > > wrote: > > > > > > All, > > > > > > AriaTosca has been incubating since August and still does not have a > > > website. IMHO this is a potential problem, especially around community > > > building. > > > > > > > > > One idea may be to use the newly crafted Apache Website Template to > build > > > the website. You can see the template here: > > > https://github.com/apache/apache-website-template - its based on > jekyll. > > > > > > The flipside, there's already http://ariatosca.org/ which I'm assuming > > is > > > this podling. It may make sense for this website to become our > website, > > > focused on the underlying Apache community. > > > > > > > > > You are correct, www.ariatosca.org is the website we brought up for > the > > > ARIA TOSCA Podling,it was brought up before it was accepted as an asf > > > Incubator project. I would like to make sure we are compliant with ASF > > > process as well, and we have all needed information there. > > > > > > Can we use this this as a starting point, add the missing information > > > expected to be there? > > > I've highlighted the gaps we should complete, based on the the Podling > > > webisite guildeline: > > > http://incubator.apache.org/guides/sites.html > > > > > > > > >- Project Home Page: the primary entry point to the site; contains > > >project description, news, invitation to join the project. > > >- License Page: usually, the Apache License 2.0 > > >- Downloads: many projects in incubation will release code, and this > > >page describes them and has links to the download pages that > redirect > > to > > >Apache Mirror sites. > > >- Documentation: this page describes the project documentation, > > >including javadoc for Java projects; guides, tutorials, and links to > > >external documentation. > > >- *Committers: *a list of current committers on the project. > > >- *Mailing Lists:* there are several mailing lists that the > community > > >might be interested in, and this page contains mailto: links that > > >allow easy subscription (and unsubscription) to any of them. > > >- *FAQ: *frequently asked questions are answered here. > > >- Road Map: if the project has a vision of future community or > > >development activities, the road map is published here. > > >- *Source Code: *links to the browsable source repository and svn > > >commands to check out the sources. > > >- Coding Standards: the coding standards for submitted code by the > > >community, along with a description of how strict the project > intends > > to be. > > >- *Issue Tracking: *links to the JIRA or other issue tracking tool, > > >possibly including frequently used filters for issue lists. > > >- Dependencies: other projects that this project depends on. > > >- favicon: the project's icon in a format suitable for a browser's > > >address bar. If absent, an Apache Feather will be displayed. > > > > > > > > > > > > > > > Once we have that ironed our, we need to figure out a solution to > getting > > > the website published. The current recommended solution is gitpubsub. > > > > > > It > > > involves setting up a buildbot to monitor this repo to rebuild the > > asf-site > > > branch, then serving that asf-site branch as the actual website. Its > > > similar to how github pages work, except you get an apache domain. > > > > > > > > > Currently www.ARIATOSCA.org is a wordpress app running on AWS.