+1

Thanks,
Ashish Vijaywargiya

On Tue, 31 Mar 2026 at 15:25, Jacopo Cappellato <[email protected]>
wrote:

> Hi all,
>
> I’ve noticed that because we currently have a README.md file inside the
> .github/ folder, that file is being displayed on the landing page of the
> project (https://github.com/apache/ofbiz-framework) instead of the
> README.adoc located in the root directory.
>
> One possible workaround would be to rename .github/README.md to avoid this
> unintended behavior. However, I’d like to propose a different approach:
> converting the root README.adoc (AsciiDoc) into a README.md (Markdown).
>
> This change could improve compatibility with GitHub’s default behavior and
> make the project more accessible to a wider audience, since Markdown is
> more commonly used and immediately rendered as expected on GitHub project
> pages.
>
> Of course, this would also require evaluating any AsciiDoc-specific
> features currently in use and ensuring they are properly translated or
> adapted.
>
> What do you think about this approach?
>
> Best regards,
>
> Jacopo
>

Reply via email to