# Building Jenkins.io with Alternative Tools

**URL:** <https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468>\
**Category:** GSoC\
**Tags:** sig-docs, sig-infra\
**Created:** [March 25, 2023, 6:28pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468 "2023-03-25T18:28:11Z")\
**Posts on this page:** 20\
**Page:** 1

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 25, 2023, 6:28pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/1 "2023-03-25T18:28:11Z")

</div>

Hi Guys, I have created my drafted proposal  
[Mahmoud\_Galal Proposal for building Jenkins.io with alternative tools](https://docs.google.com/document/d/1VpqTZ5r6fmKQvGOn7OPXgYXXoX65TZK8BBBfUvZu09E/edit?usp=sharing)

For [Building Jenkins.io with alternative tools](https://www.jenkins.io/projects/gsoc/2023/project-ideas/alternative-jenkinsio-build-tool/)

I would love to hear the feedback from potential GSoC mates and The mentors

@MarkEWaite @krisstern for your gentle review

---

<div class="post-metadata">

**Author:** ![Jmm](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/jmm/32/495_2.png) [@Jmm](https://community.jenkins.io/u/Jmm)\
**Post date:** [March 25, 2023, 7:18pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/2 "2023-03-25T19:18:33Z")

</div>

Well done.  
Thank you for providing your draft for review, Mahmoud.

/- Jmm

---

<div class="post-metadata">

**Author:** ![Jmm](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/jmm/32/495_2.png) [@Jmm](https://community.jenkins.io/u/Jmm)\
**Post date:** [March 25, 2023, 7:24pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/3 "2023-03-25T19:24:57Z")

</div>

> [@Mahmoudgalalz](#):
>
> Mahmoud\_Galal Proposal for building [Jenkins.io](http://Jenkins.io) with alternative tools

Oops. Don’t forget to put “everyone with the link” as commenter. At a first glance, several important parts (background, experience, motivations, etc) are missing. It is advised to use the recommended template.

/- Jmm

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 25, 2023, 10:03pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/4 "2023-03-25T22:03:47Z")

</div>

Done, I’m still preparing at and I will mention here again when it’s completely done for the first review

/- Mahmoud

---

<div class="post-metadata">

**Author:** ![Jmm](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/jmm/32/495_2.png) [@Jmm](https://community.jenkins.io/u/Jmm)\
**Post date:** [March 26, 2023, 7:49pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/5 "2023-03-26T19:49:28Z")

</div>

Perfect Mahmoud

Thank you to help us in trying to keep on top of the many proposals.

/- Jmm

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 28, 2023, 8:17pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/6 "2023-03-28T20:17:38Z")

</div>

Hello dear Mentors and Org Admins

@Jmm @krisstern @iamrajiv @MarkEWaite

I’m asking for the 1 iteration on reviewing my Proposal, waiting to discuss the approaches that I come up with in my proposal

Thanks  
/- Mahmoud Galal aka KroKing

---

<div class="post-metadata">

**Author:** ![Jmm](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/jmm/32/495_2.png) [@Jmm](https://community.jenkins.io/u/Jmm)\
**Post date:** [March 29, 2023, 10:24am UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/7 "2023-03-29T10:24:14Z")

</div>

You are right, Mahmoud, the Community is waaay behind reviewing your proposal. Calling here for mentoring help.

/- Jmm

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 6:21pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/8 "2023-03-29T18:21:56Z")

</div>

I really want one of the mentors to discuss some points related to the approach we should follow

I have mentioned there are two ways to consider moving to Antora

one is to separate the content alone in the repo which is the way Antora docs says

and UI can be within the automation server

The other way is combining all this in one repo and It can be done with versioning as mentioned in the Antora doc we can do versioning using Tags, Branched, or directories names

I discussed with @krisstern on gitter but I think she didn’t get my point. what I did understand from her which we are trying our best to have one repo, which will have blogs using gatsby and Docs with anotra, and the rest of the website will remain Awstruct and haml, this will lead us to use monorepo architecture.

I have no problem doing any of these approaches but I want my proposal to be with one view, my proposal now has pointed to these two approaches

Thanks @Jmm  
/- Mahmoud

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 6:26pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/9 "2023-03-29T18:26:50Z")

</div>

Also, I have mentioned that I made a demo demonstrating using [Jenkins.io](http://Jenkins.io) components

and Antora  
[https://mahmoudgalalz.github.io/Jenkins.io-new/](https://mahmoudgalalz.github.io/Jenkins.io-new/)

> **[GitHub - Mahmoudgalalz/Jenkins.io-new](https://github.com/Mahmoudgalalz/Jenkins.io-new)**
>
> Contribute to Mahmoudgalalz/Jenkins.io-new development by creating an account on GitHub.

---

<div class="post-metadata">

**Author:** ![Jmm](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/jmm/32/495_2.png) [@Jmm](https://community.jenkins.io/u/Jmm)\
**Post date:** [March 29, 2023, 8:50pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/10 "2023-03-29T20:50:44Z")

</div>

Hello @Mahmoudgalalz ,

I understand your doubts and your questions are legitimate.

As said during Office Hours, mentors will not tell you (and might not know) what is the best solution. We expect you to be able explain the options clearly and choose/recommend (with argumentation) your solution. We are interested to see in your proposal your communication skills, creativity, and knowledge on the subject matter.

The mentor’s draft review are mainly there to guide you on correctly explaining your proposal, on good comprehension of the problem to solve, and avoid errors.

I fear that calling for a clarification meeting is quite late at this stage of the timeline. But it depends on the availabilities of mentors. They have been quite stretched seen the very large number of proposals and candidates. Don’t forget that they have other responsibilities besides GSoC.

I want to thank Kris (@krisstern ) for his incredible availability and implication in reviewing proposals and relentlessly answering the numerous questions.

/- Jmm

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 9:24pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/11 "2023-03-29T21:24:44Z")

</div>

Thanks @Jmm I got what you mention for, and I will be discussing them in my proposal

also, I would really than @krisstern and I admit she was very available most of the times for all community, Thanks @krisstern so much

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 10:19pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/12 "2023-03-29T22:19:57Z")

</div>

Hi @Mahmoudgalalz We will be replacing Awestruck for the entirety of the website as a drop-in replacement, but will start with the Documentation and Blog. This is one issue to be discussed in your proposal on your own, and we would like to stick to a single-repo structure. So I think perhaps there have been some misunderstandings somewhere, as I never expressed we will keep Awestruck at all.

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 10:27pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/13 "2023-03-29T22:27:01Z")

</div>

> [@Mahmoudgalalz](#):
>
> one is to separate the content alone in the repo which is the way Antora docs says

Regarding this statement, I believe there must be a way to make this work within a single repo with different directories for the different parts of the website. I will leave it open for you to suggest how this could be implemented. But this approach undoubtedly will involve a lot more work than you seem to be thinking.

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 10:34pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/14 "2023-03-29T22:34:04Z")

</div>

> [@Mahmoudgalalz](#):
>
> The other way is combining all this in one repo and It can be done with versioning as mentioned in the Antora doc we can do versioning using Tags, Branched, or directories names

Please note that you can always define a content source root other that the repo root. (See: [Repositories and Content Source Roots :: Antora Docs](https://docs.antora.org/antora/latest/content-source-repositories/#content-source-root.))

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 10:55pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/15 "2023-03-29T22:55:32Z")

</div>

Okay, but it’s not part of the GSoC, it will be replaced later after GSoC

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 11:07pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/16 "2023-03-29T23:07:20Z")

</div>

Sorry I never said that, and Awestruck will be replaced in the drop-in replacement during GSoC.

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 11:07pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/17 "2023-03-29T23:07:38Z")

</div>

yeah I do know, and I researched for that and I come up with the implementation approach, so you think I should remove this from my proposal and not considering it at all

---

<div class="post-metadata">

**Author:** ![Mahmoudgalalz](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/mahmoudgalalz/32/3720_2.png) [@Mahmoudgalalz](https://community.jenkins.io/u/Mahmoudgalalz)\
**Post date:** [March 29, 2023, 11:09pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/18 "2023-03-29T23:09:39Z")

</div>

> [@krisstern](#):
>
> drop-in replacement

Can you please clarify what you mean by drop-in replacement,  
do you mean we will combine our work with the main repo and we will use Awestruck for the rest of the website?

as we will do a just monorepo of Docs and Blogs and then combine it with the main one and remove the docs and blogs from Awestruck

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 11:16pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/19 "2023-03-29T23:16:58Z")

</div>

By drop-in replacement it means the project should be ready to be deployed at any time after the conclusion of GSoC to replace the existing [jenkins.io](http://jenkins.io) `master` branch.

We will be redoing / revamping the code at the `master` branch of [GitHub - jenkins-infra/jenkins.io: A static site for the Jenkins automation server](https://github.com/jenkins-infra/jenkins.io) for this project, so it may or may not involve just the Documentation and Blog, plus also everything else currently on the site, while replacing Awestruck with Antora. The scope really depends on the coverage of your proposal.

---

<div class="post-metadata">

**Author:** ![krisstern](https://dub1.discourse-cdn.com/flex013/user_avatar/community.jenkins.io/krisstern/32/824_2.png) [@krisstern](https://community.jenkins.io/u/krisstern)\
**Post date:** [March 29, 2023, 11:18pm UTC](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468/21 "2023-03-29T23:18:29Z")

</div>

> [@Mahmoudgalalz](#):
>
> yeah I do know, and I researched for that and I come up with the implementation approach, so you think I should remove this from my proposal and not considering it at all

I did not say that. I have no idea where your interpretation is coming from.

[Next page](https://community.jenkins.io/t/building-jenkins-io-with-alternative-tools/6468.md?page=2)
