TYPO3-Documentation / sphinx_typo3_theme

Sphinx theme for docs.typo3.org
https://typo3-documentation.github.io/sphinx_typo3_theme
MIT License
28 stars 17 forks source link

Change request: 'view source' and 'Edit on GitHub' buttons could open in a new window #182

Closed vb-benjamin-eyring closed 1 year ago

vb-benjamin-eyring commented 1 year ago

Hi all,

Bildschirm­foto 2023-01-05 um 14 36 17

I would like to propose to open the buttons 'View source' and 'Edit on GitHub' in a new window like 'How to edit' already does. From my point of view this would be the expected behaviour.

I already had a discussion about that in slack with Lisa Wolf and I also can understand her point of view:

https://typo3.slack.com/archives/C028JEPJL/p1672925228168839

Not sure how to proceed from here - I could ask some colleagues on their opinion. Or do we have a voting tool at hand? Or do you decide in some team or forum on such ideas?

Thx, Ben

sypets commented 1 year ago

My 2 c: A quite simple method is to upvote or downvote an issue using :thumbsup: or :thumbsdown: on the issue.

This is quite common in other open source projects (but not so common in TYPO3, but we could establish it here as well).

Since I am too lazy to open Slack and not everyone is in Slack, could you summarize the argument that were given? Please no copy pasting of screenshots.

All of the above is my personal opinion, not official.

About the proposal: I agree and have used :thumbsup:

sypets commented 1 year ago

Apart from that: this is not a democracy, but I think it is sometimes helpful to get a general idea of what the community wants though using the up / downvote in an issue is a crude unsatisfactory method and not statistically relevant but better than nothing.

The number of watchers in TYPO3 core issues on Forge is also often quite helpful.

vb-benjamin-eyring commented 1 year ago

Up/Downvote sounds good! As you mentioned that in general there is no democratic process for decisions - then who makes the decision? Would I have to approach anyone for such a change request? Or are the change requests scanned on a regular basis?

DavidBruchmann commented 1 year ago

I agree on the main proposition to open the link in a new window.
Also the link "how to edit" should perhaps open in a new window, but there it's done already.
My reason is that those sites might be viewed side-by-side to get any edits in the fastest and best way resolved and that it's probably not helpful just to change the current window content to another site.

DavidBruchmann commented 1 year ago

Concerning the voting I object, because down-voting might tend to discourage people from engagement. While it might be helpful for routined users, especially new users see it as a negative feedback beyond a simple voting process.
So concerning objections I think it's better to write justified explanations.

DavidBruchmann commented 1 year ago

@linawolf you keep your opinion about the target of the buttons or you could reconsider perhaps?

marble commented 1 year ago

I tend to use "open in new window" for all of the three buttons and see whether there is some protest. However, I'll do some experiments on different devices first.

vb-benjamin-eyring commented 1 year ago

That sounds good to me. thx

marble commented 1 year ago

Done and solved in https://github.com/TYPO3-Documentation/sphinx_typo3_theme/commit/35f0e2d33ffcadf8a8b659c790c63de3a811b4b7