articles: Add language server in the FreeBSD src tree guide

[khng]

Summary

This guide is to introduce the use of language server daemon in the
FreeBSD src tree.

Sponsored by: The FreeBSD Foundation

[khng]

Wording changes and toc fixes

[ceri]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

83

Is “whitelist” a baked in term or can we use “allowlist” instead?
(not asking about merit here, just whether there is code outside the scope of this doc that requires this to say “whitelist”).

237

“if it is present”

[khng]

Wording changes.

[bcr]

Cool, I like this addition of language servers. I added some language improvements.

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

34

The use of you is discouraged in technical documentation.

75

s/if you are using/when using/g

142

s/if you run/when running/g

207

Another use of "you" here.

237

Line break needed here before "Entries" (one sentence per line).

243

s/Once compilation/Once the compilation/
s/you can open/open/ (active voice, avoid use of you)

244

s/give complete result/give a complete result/

245

s/in compilation/in the compilation/
s/thus you would not see complete/thus no complete results are shown/

[pauamma_gundo.com]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

3

Missing "the"/"a" here?

8

Ditto

13

And again.

146

177

208

Missing comma before "merged"?

209

[ygy]

It generally looks good to me, and it is a really nice read! Added some minor nits. Thanks for doing this.

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

56

102

140

214

230

[khng]

Updated.

[khng]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

177

I reworded the whole part to match the exact behavior.

[khng]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

3

This should be capitalized instead in my opinion because I meant a technology here.

8

same as above.

13

same as above.

208

I don't get this.

209

I don't get this either.

[khng]

Updated title

[pauamma_gundo.com]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

208

The line this was meant to apply to probably moved due to other changes, and I can't find it anymore. Ignore at will.

209

Same.

[ygy]

documentation/content/en/articles/freebsd-src-lsp/_index.adoc

3

This looks a bit weird to my eye as well - maybe adding an "a"?

35

106

147

242

249

[khng]

ygy@ fixes

[ygy]

Thanks for making all the changes! This looks good to my eye, and I am happy to see it in the tree.

title: Deploying a Language Server in the FreeBSD src tree

One last comment is that, after another look, the title has some ambiguity to me. I think it could be something like:

title: Use Language Servers for Development in the FreeBSD src tree

What do you think? @khng @ceri @bcr

[khng]

Better title given by ygy@

[ygy]

I'd wait for other reviewers on this thread to see if they have additional comments, but again, this looks good to me. Thanks! :)

[khng]

Capitalized title