Thank you @tomekcedro, @acassis, and @matteogolin for the warm welcome and valuable feedback!
I completely agree that starting small is the best approach. Based on your suggestions, here's my revised plan: Immediate Next Steps: 1. Start with small, focused PRs addressing specific configuration issues I've found: - Issue #12638: SPI configuration on ESP32-S3 - Issue #12636: Filesystem configuration build failure - Issue #12629: Virtio console configuration for arm64/qemu 2. For each issue, I'll: - Document the solution clearly - Add troubleshooting steps - Include examples where helpful - Submit as separate PRs to the website repository 3. Once I've gained more experience with the configuration system through these small fixes, I'll revisit the larger Configuration Guide idea with a more informed perspective. Question for the community: Would it be helpful if I document my process for solving these issues? This could serve as "real-world configuration examples" for future users. Thank you again for the guidance - I'm excited to start contributing! Best regards, Siddhi Tripathi On Thu, Feb 19, 2026 at 3:53 AM Matteo Golin <[email protected]> wrote: > Hi Siddhi, > > Welcome to NuttX! I think before undertaking this very large task of > configuration documentation, it might be best to tackle it in small steps > as Tomek mentioned. I see you listed a couple issues from the GitHub in > your email already; you're more than welcome to submit solutions for any of > those issues as a good first step! > > Matteo > > On Wed, Feb 18, 2026 at 4:12 PM Alan C. Assis <[email protected]> wrote: > > > Hi Tomek, > > > > Siddhi is interested in participating in GSoC, but the site design is not > > part of the GSoC. > > > > I agree with you, the design he submitted is good, but needs more > > improvements. > > > > So, now that his initial PR is merged, let's see how the site will > render. > > > > I saw you found some issues, but let more people take a look at > it,probably > > we will receive more improvement suggestions. > > > > BR, > > > > Alan > > > > On Wed, Feb 18, 2026 at 5:09 PM Tomek CEDRO <[email protected]> wrote: > > > > > Hello Siddhi :-) > > > > > > Documentation contributions are always welcome. Just do not redesign > > > the whole thing. Small steps measurable results are the best, so > > > please start small, you will get familiar with the tools and process, > > > add missing parts for start :-) > > > > > > This does not sound like GSoC project but I may be wrong. > > > > > > Please note that the best work is done yourself with deep > > > understanding considering this documentation serves as reference point > > > for everyone else. Please only use AI tools when necessary for grammar > > > corrections only, so you can fully enjoy your own work results. > > > > > > -- > > > CeDeROM, SQ7MHZ, http://www.tomek.cedro.info > > > > > > On Wed, Feb 18, 2026 at 7:48 PM Siddhi Tripathi > > > <[email protected]> wrote: > > > > > > > > Hello NuttX community, > > > > > > > > I'm a first-year B.Tech student who has been contributing to the > > > > nuttx-website > > > > repository (I have 3 merged PRs so far). I'm interested in working on > > > > improving the configuration documentation, potentially as part of > GSoC > > > 2026. > > > > > > > > ## Why This Is Needed > > > > > > > > **1. Systemic Problem (Issue #16420):** > > > > > "There are many places in NuttX where configuration defaults are > set > > in > > > > the > > > > > source code, not from Kconfig. This should be handled by Kconfig > only > > > > > otherwise it can lead to hard to detect problems." > > > > > > > > This open issue, raised by @raiden00pl and confirmed by @acassis and > > > > @xiaoxiang781216, confirms that configuration fundamentally confuses > > > users > > > > because CONFIG_ macros appear in code that don't come from Kconfig. > > > > Link: https://github.com/apache/nuttx/issues/16420 > > > > > > > > **2. Additional Open Issues:** > > > > I've identified these related open issues: > > > > - Issue #12638: xtensa/esp32s3: Broken SPI configuration due to > Kconfig > > > > changes > > > > Link: https://github.com/apache/nuttx/issues/12638 > > > > - Issue #12636: Build fails when disabling all filesystem support > > > > Link: https://github.com/apache/nuttx/issues/12636 > > > > - Issue #12629: arm64/qemu: Wrong configuration for Virtio console > > > > Link: https://github.com/apache/nuttx/issues/12629 > > > > > > > > **3. Real User Struggles:** > > > > - User having trouble with SPI configuration on ESP32-S3: > > > > https://lists.apache.org/thread/6oz6k7zfc7v4qx3dyt0o3ppf9n6rvzrw > > > > - Question about disabling filesystem features: > > > > https://lists.apache.org/thread/8roqonqo1b9lwob7p8o8k0f4k4l4k4l4 > > > > - Discussion about virtio console configuration: > > > > https://lists.apache.org/thread/9spqprq1c8v5qx3dyt0o3ppf9n6rvzsw > > > > > > > > **4. Fragmented Documentation:** > > > > Configuration information currently exists in README files but is not > > > fully > > > > migrated to the main website, making it harder for new users to find. > > > > > > > > ## Proposed Solution > > > > > > > > I'd like to create a comprehensive **NuttX Configuration Guide** on > the > > > > main > > > > website covering: > > > > > > > > - Configuration fundamentals: Kconfig, .config, defconfig > relationships > > > > - Working with "canned" configurations: ./tools/configure.sh usage > > > > - menuconfig deep dive: Navigation, search, hidden options (with > > > > screenshots) > > > > - Understanding CONFIG_ macros: Explaining the issue from #16420 > > > > - Common configuration tasks: Real examples from issues/threads > > > > - Troubleshooting guide: Based on actual user problems > > > > - Best practices: Avoiding hardcoded values, proper Kconfig > > organization > > > > > > > > ## Questions for the Community > > > > > > > > 1. Does this align with current documentation priorities? > > > > 2. Are there specific configuration topics you'd like prioritized? > > > > 3. Would this be better as a new "Configuration Guide" section or > > > > integrated > > > > into existing documentation? > > > > 4. Is there any existing work I should build on? > > > > > > > > ## Next Steps > > > > > > > > I plan to: > > > > - Gather feedback from this RFC (1 week) > > > > - Create a detailed GitHub issue with outline > > > > - Start drafting content section by section > > > > - Share progress for community review > > > > > > > > I'm happy to start with a small PR as a proof of concept and iterate > > > based > > > > on feedback. > > > > > > > > Thank you for your time and guidance! > > > > > > > > Best regards, > > > > Siddhi Tripathi > > > > GitHub: siddhitripathi25 > > > > > >
