Hi Geode Dev Community, I want to recognize the sustained effort Patrick and the team have put into modernizing the Apache Geode website and documentation. This is an important step for the project, not only in updating the technology behind the site, but also in making our documentation and contribution experience more accessible to the community.
I am very excited to see us move closer to going live with a refreshed public face for Apache Geode. The website is often the first place users and prospective contributors encounter our project, so this work is an important part of how we welcome, inform, and grow the community. As we move toward that milestone, community participation is especially valuable. I would greatly appreciate your review, feedback, and support for the proposed direction and the current pull request. Please share any concerns, suggestions, or areas where you can help. This is a community project, and the strongest outcome will come from shaping it together. Thank you to everyone who has contributed to this effort and to those who can help us bring it across the finish line. Best regards, Jinwoo Hwang (he/him/his) SAS® Research and Development http://JinwooHwang.com<http://jinwoohwang.com/> From: Patrick Harmon via dev <[email protected]> Date: Monday, October 19, 2026 at 9:14 AM To: [email protected] <[email protected]> Cc: Patrick Harmon <[email protected]> Subject: Re: GEODE-10582 - Documentation Modernization Hi Geode Dev Community, I wanted to say hello again and mention that I have submitted an initial PR for the geode-site modernization. I have not had as much time as I wanted to make a perfect 100% completed version of the website documents. But it is very far along, and it may go faster to be fully complete if I can push this in and get community help for the rest. https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fgeode-site%2Fpull%2F31&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841839343%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=GEmGto5PftWZMEGC%2BobHz8M7M3uaASAObQFpmwYXnwU%3D&reserved=0<https://github.com/apache/geode-site/pull/31> Thank you, Patrick Harmon @patrickharmon (Geode Jira) @harmoncoffee (GitHub) On Friday, April 24, 2026 at 02:58:09 PM EDT, Bryan G. Behrenshausen <[email protected]> wrote: Thanks for this great overview of our work so far, Patrick. I have nothing to add, except to underscore your request for review and feedback. Patrick and I are very keen to hear what the community thinks of this direction. Bryan On 2026-04-24 11:44 AM, Patrick Harmon via dev wrote: > Hi Geode Dev Community, > My name is Patrick Harmon, and I'm a member of the SAS team working to > modernize Geode. I was real interested in the recent effort to update the > Apache Geode project website: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fissues.apache.org%2Fjira%2Fbrowse%2FGEODE-10468___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6Nzo2MGMyOjc1Y2NkNjE2ZjU1MzM1M2I3MjI3OWRmMjU2NmI2YjI3MGNjMDBhYjQxNzYyNTg4ZmZlYjBmOTllNWE4Y2E2MjM6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841861564%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=Mg0mLwFJOx%2FrzJqGbX5pLyQYBms4b9VHSdC38v62iYE%3D&reserved=0<https://protect.checkpoint.com/v2/r01/___https://issues.apache.org/jira/browse/GEODE-10468___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6Nzo2MGMyOjc1Y2NkNjE2ZjU1MzM1M2I3MjI3OWRmMjU2NmI2YjI3MGNjMDBhYjQxNzYyNTg4ZmZlYjBmOTllNWE4Y2E2MjM6cDpUOk4> > (Modernization of Apache Geode Website) > For the past few months, my colleague Bryan Behrenshausen and I have been > working on issues related to this effort. Some of these include: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fissues.apache.org%2Fjira%2Fbrowse%2FGEODE-10485___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6NzpkMWQ5OjE2YmUxNTFhNjg3NjVlMjkxOTEwODE1NjU5MDBiNzViNzBmNTQ0NzQ5NzMxNTU4MjVkZmFmMzU3MjdlMzFmZDM6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841891353%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=VOyO%2FwekWh2qUDyy%2BQujKbl6k5MklDRJgr0QqEguI%2Fk%3D&reserved=0<https://protect.checkpoint.com/v2/r01/___https://issues.apache.org/jira/browse/GEODE-10485___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6NzpkMWQ5OjE2YmUxNTFhNjg3NjVlMjkxOTEwODE1NjU5MDBiNzViNzBmNTQ0NzQ5NzMxNTU4MjVkZmFmMzU3MjdlMzFmZDM6cDpUOk4> > (Upgrade to latest website > template)https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fissues.apache.org%2Fjira%2Fbrowse%2FGEODE-10582___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6NzpmYjc4OmY0N2JlZmYyMGNkNTE3ZjFmZThkYjgzYzNjYWE4OTQ1Yzg0MjFlNTUwNjBhYTI0ZDBhZjIzNTU4OWExMTI0MTc6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841904316%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=UfOjCARk7pcRjDkvv5slcQafwLqyfQsguyKUh70Oze0%3D&reserved=0 > (documentation > modernization)https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fissues.apache.org%2Fjira%2Fbrowse%2FGEODE-9956___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6Nzo3NDhiOjFiZWRmZDY1NGIzNThlM2E1ZTQ3ZWFmNjI3ZGRmODVjN2U3Mzg5MmY4MjRmMjMzNjg5NTVmZTE5Njc4ZTcxNDg6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841916658%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=EUA2wD0s0N3mR9on%2BuuGhDOmKTLLJnS0%2B4ow%2BkNgFG4%3D&reserved=0 > (update website generation tools) > Our work has been progressing, and I'd like to share with you what we've done > so far. I'd also like to get your feedback on our proposed updates and some > of the process changes we're imagining. > The first thing we did was port the Geode website to the docusaurus-based ASF > website template: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fapache-website-template&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841927113%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=sf%2BTtipQeI1Iboyvk8XwIzXvoWjaaXlR4Xb4bx8HJ%2Bw%3D&reserved=0<https://github.com/apache/apache-website-template> > Starting from that template, we have been able to continue modernizing the > Geode site. And by working with the template, we were able to ensure that the > new site is aligned with ASF branding and trademark policies: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fissues.apache.org%2Fjira%2Fbrowse%2FGEODE-10474___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6NzpmNTUzOjhjODUzYWY4ZjBjYjg4NzAwYWM4Y2U5MDc1NzljNzJmNDFiOTEwNWEzYjM0Mzk4NTU0MWNlZGNmODQ4N2NhMzU6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841938348%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=QhzwPNVuYHJh37f7thAL7SMYLvyWF0NPbl8N1wTu2As%3D&reserved=0<https://protect.checkpoint.com/v2/r01/___https://issues.apache.org/jira/browse/GEODE-10474___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6NzpmNTUzOjhjODUzYWY4ZjBjYjg4NzAwYWM4Y2U5MDc1NzljNzJmNDFiOTEwNWEzYjM0Mzk4NTU0MWNlZGNmODQ4N2NhMzU6cDpUOk4> > (Branding updates on website) > I plan to raise a draft PR when it's a little more polished, but the code > currently resides on a feature branch: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fharmoncoffee%2Fgeode-site%2Ftree%2FGEODE-10468&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124841948598%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=%2F%2FXxmGpBcwAsMYR0vDkhJuJKcYH%2FkoUPCPuVHeZyZ%2FI%3D&reserved=0<https://github.com/harmoncoffee/geode-site/tree/GEODE-10468> > You can see a working prototype of the new site here: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fprotect.checkpoint.com%2Fv2%2Fr01%2F___https%3A%2F%2Fapachegeode.pharmondev.com%2F___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6Nzo1OTkxOjc3M2E2YTAwY2FmY2RjZDlhMmY3NTJkZTllODkyMjI0NjVkYmNiYzhmMzdkNjY0ODYwMTQ0NDQxM2E5MGMwZDY6cDpUOk4&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124842109714%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=q5MRfHmS48QilJZPvx80oc1kA0qNFDN%2Fei3a2dBLq6k%3D&reserved=0<https://protect.checkpoint.com/v2/r01/___https://apachegeode.pharmondev.com/___.YzJ1OnNhc2luc3RpdHV0ZTpjOm86MGY1ODdkZDgxYzM0OThlNDM1MDE2ZmRiMTc3NjZkYjA6Nzo1OTkxOjc3M2E2YTAwY2FmY2RjZDlhMmY3NTJkZTllODkyMjI0NjVkYmNiYzhmMzdkNjY0ODYwMTQ0NDQxM2E5MGMwZDY6cDpUOk4> > (It's hosted on AWS, and it pulls my local branch and refreshes when commits > are done. I wanted to wait until there was enough progress on it to share > here.) > Here's a list of the primary tasks we've completed so far: > - Using a docusaurus based environment for hosting the geode-site. - > Organization of existing docs to mostly match the old website, on the side > navigation bar. - Arranging the initial site page to provide most of the same > content from geode.apache.org > And here's what's in progress: > - Migration of Apache Geode 1.15 docs- Validating all links, images, and > anchors are fixed when rearranging the file directories. I believe at > approximately 600 links are still broken, and 200 anchors need fixing (at > least based on automatic docusaurus validation) > On our list (but not yet started) are: > - Once Completed with 1.15, add the new 2.x versions to the doc- Migration of > native docs, for C++ and .NET 1.15 versions, and if need any changes for 2.x > add that- Documentation on how to contribute to geode site when using > docusaurus- Removal of old geode docs on the main 1.15, and 2.x branches > A few final notes, too: > 1. This proposed site upgrade does change the working location of the Geode > documentation. Currently, the documentation resides in the Geode project > repository and gets built with a Ruby-based toolchain: > https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fgeode%2Ftree%2Fdevelop%2Fgeode-docshttps%3A%2F%2Fgithub.com%2Fapache%2Fgeode%2Ftree%2Fdevelop%2Fgeode-book&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124842125538%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=4w3BYITpWIPrZQEHCzh6TMgLUrWyapgnXkb%2FDIudd2M%3D&reserved=0<https://github.com/apache/geode/tree/develop/geode-docshttps://github.com/apache/geode/tree/develop/geode-book> > Docusaurus-based sites expect the documentation to be in the same location as > the website files themselves—hence the need to migrate all existing > documentation to the geode-site repository > (https://nam02.safelinks.protection.outlook.com/?url=https%3A%2F%2Fgithub.com%2Fapache%2Fgeode-site&data=05%7C02%7CJinwoo.Hwang%40sas.com%7C3dbc712dd32a44b3662008df2de2ec69%7Cb1c14d5c362545b3a4309552373a0c2f%7C0%7C0%7C639280124842135966%7CUnknown%7CTWFpbGZsb3d8eyJFbXB0eU1hcGkiOnRydWUsIlYiOiIwLjAuMDAwMCIsIlAiOiJXaW4zMiIsIkFOIjoiTWFpbCIsIldUIjoyfQ%3D%3D%7C0%7C%7C%7C&sdata=6n%2FL1R4kbu1v05HQBZ%2BJq8ZzDOLrLj1%2FJmzpFiacYM4%3D&reserved=0<https://github.com/apache/geode-site>). > I do not believe there would be any reason to retain documentation inside > the Geode development rather just in the geode-site repository. So with this > change, we would likely be suggesting the deprecation of the previous > documentation system and location. > 2. Docusaurus can utilize markdown, very similar to the existing > documentation. So I have stripped most of the files and put them into > markdown files, then adjusted the yaml front matter to organize and name the > content. Since I'm utilizing auto-formatting of docusaurus, I went through > each document and explicitly ordered them with the front matter. As you > review, please help me ensure that our content listings are correct. > I was talking with Jinwoo Hwang (Geode PMC member and my SAS colleague), and > my initial thought is to keep just 1.15.x, and 2.x documentation versions > updated on the website, as these are the only two supported Geode versions. > This can be revisited if we need to, but I believe that once I have the > entirety of the documentation renamed and formatted, with links working, I > will go through a diff phase of the other versions and see how much really > changed, maybe add those independently if we believe it's required. I have > not analyzed this separately yet. > I would love to hear some feedback, thoughts, and suggestions. > Thank you, Patrick Harmon @patrickharmon (Geode Jira) @harmoncoffee (GitHub) >
