Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

No obvious way to report issues with the parent logging site #3098

Closed
sebbASF opened this issue Oct 16, 2024 · 5 comments
Closed

No obvious way to report issues with the parent logging site #3098

sebbASF opened this issue Oct 16, 2024 · 5 comments
Assignees
Labels
documentation Pull requests or issues that affect documentation

Comments

@sebbASF
Copy link

sebbASF commented Oct 16, 2024

As the subject says: where should one report issues with logging.apache.org?

@ppkarwasz
Copy link
Contributor

Feel free to report the problem here.

@sebbASF
Copy link
Author

sebbASF commented Oct 16, 2024

Thanks.

This report in itself is an issue: i.e. no obvious documentation on where to raise such website issues.
(I'll raise separate issues for unrelated problems)

@vy
Copy link
Member

vy commented Oct 17, 2024

@sebbASF, logging.apache.org has a menu item, Support, at the top. That page documents User support communication channels and several other things in the context of support. I presume you already figured this out yourself, but still didn't find any of the comm. channels listed there suitable to your needs. How can we adapt that page to help you?

@vy vy added waiting-for-user More information is needed from the user documentation Pull requests or issues that affect documentation and removed waiting-for-maintainer labels Oct 17, 2024
@vy vy self-assigned this Oct 17, 2024
@sebbASF
Copy link
Author

sebbASF commented Oct 17, 2024

The section at https://logging.apache.org/support.html#issues links to various issue trackers for sub-projcects, but does not provide info on how to report generic issues.

A related problem is the reporting template for issue lists such as this one is not really suited to reporting website issues. The project might wish to consider enabling issues on the logging website repo(s) and link to them from the relevant website pages

@github-actions github-actions bot added waiting-for-maintainer and removed waiting-for-user More information is needed from the user labels Oct 17, 2024
@vy
Copy link
Member

vy commented Oct 17, 2024

The section at https://logging.apache.org/support.html#issues links to various issue trackers for sub-projcects, but does not provide info on how to report generic issues.

Got it. Updated l.a.o/support.html to guide on "not project1-specific" inquiries.

1 I know, Log4j is not a project, but a subproject. Though almost all users (including several ASF members! 🤦) are not aware of this fact.

A related problem is the reporting template for issue lists such as this one is not really suited to reporting website issues. The project might wish to consider enabling issues on the logging website repo(s) and link to them from the relevant website pages

On 2024-09-03, we migrated the websites of Log4j and related projects to Antora. We deliberately worked hard to ensure each Antora page is decorated with a working Edit button at the top. It helped enormously – since then users contributed several website fix PRs and issues. We intend to migrate l.a.o to the same setup too.

I would refrain from disclosing the website repositories and documenting them. They are an internal implementation detail, they are intertwined in a sophisticated manner, and their setup is on the flux (for instance, the cited Antora change significantly disrupted that landscape, in a positive way).

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
documentation Pull requests or issues that affect documentation
Projects
None yet
Development

No branches or pull requests

3 participants