Thanks Matteo, that makes sense. I'll move to the main nuttx repo for these.
Quick question - for #12638, should I add spi.rst in Documentation/platforms/xtensa/esp32s3/ ? And noted about the writing. Still getting used to how things work here. Thanks, Siddhi On Thu, Feb 19, 2026 at 10:34 AM Matteo Golin <[email protected]> wrote: > That sounds fine, but don't submit those issue fixes to the website > repository; they would be for the NuttX kernel. And again, please avoid > using AI to write your emails here, the text is quite repetitive. > > Good luck! > Matteo > > On Wed, Feb 18, 2026 at 11:20 PM Siddhi Tripathi < > [email protected]> wrote: > > > 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 > > > > > > > > > > > > > > >
