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

installer: offer the built-in FSMonitor explicitly as an option #351

Merged
merged 2 commits into from
May 28, 2021

Conversation

dscho
Copy link
Member

@dscho dscho commented May 28, 2021

It has been simmering in Git for Windows for a full release cycle, now it is time to give it even wider exposure. This is how the page looks at the moment:

We might want to have a link to a verbose description of the built-in FSMonitor (such as a blog post), but I am not aware of any web page to which we could link. Maybe I'll have to blog about it...

Instead of using a rather violent term, try to describe better what
these options are all about.

Signed-off-by: Johannes Schindelin <[email protected]>
@dscho
Copy link
Member Author

dscho commented May 28, 2021

I will want to have that in -rc2, which I will start preparing now.

Copy link
Member

@mjcheetham mjcheetham left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Had you considered any of these alternative names for the option?

  • Enable experimental file system monitor
  • Enable experimental built-in FSMonitor
  • Enable experimental built-in file system monitor

"FSMonitor" vs spelling out "file system", and/or specifying this is the built-in flavour of FSMonitor (because external fsmonitor support exists today).

LGTM otherwise.

@dscho
Copy link
Member Author

dscho commented May 28, 2021

Had you considered any of these alternative names for the option?

* Enable experimental file system monitor

* Enable experimental built-in FSMonitor

* Enable experimental built-in file system monitor

"FSMonitor" vs spelling out "file system", and/or specifying this is the built-in flavour of FSMonitor (because external fsmonitor support exists today).

LGTM otherwise.

Good points. Do you (as a native speaker) have any preference?

@mjcheetham
Copy link
Member

Personally, I'd be in favour of spelling out "file system" and including "built-in".

@dscho
Copy link
Member Author

dscho commented May 28, 2021

This is it, then!

Enable experimental built-in file system monitor

The built-in FSMonitor was included in Git for Windows v2.31.0 already,
but judging from the lack of bug reports, not many users found out about
the fact that it exists.

Let's change that.

Signed-off-by: Johannes Schindelin <[email protected]>
@dscho dscho force-pushed the fsmonitor-as-experimental-option branch from 7b06d6b to b513558 Compare May 28, 2021 08:51
@dscho
Copy link
Member Author

dscho commented May 28, 2021

@dscho dscho merged commit 958aff0 into git-for-windows:main May 28, 2021
@dscho dscho deleted the fsmonitor-as-experimental-option branch May 28, 2021 08:57
@dscho
Copy link
Member Author

dscho commented May 28, 2021

@mjcheetham thank you for helping me improve this last-minute PR!

dscho added a commit that referenced this pull request May 28, 2021
The experimental, built-in file system monitor
[is now featured as an experimental option in the
installer](#351).

Signed-off-by: Johannes Schindelin <[email protected]>
@PhilipOakley
Copy link
Contributor

I like the spelling out in full.

If the checks on showing the experimental pages allow, maybe do add the "(FSMonitor)" abbreviation, as a postscript, so folk realise the link when they read docs and blogs.

@dscho
Copy link
Member Author

dscho commented May 28, 2021

It's really narrow what's allowed. Even the code for showing those links is quite the hack.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

3 participants