https://discord.umbraco.com logo
Join Discord
Powered by
Hi everyone, Rich here sat in the corner by the be...
# contributing
j
Hi everyone, Rich here sat in the corner by the beers (?!) - I'm going to be working on improving the Tutorial documentation and starter material (i.e. the /fundamentals/ parts of the documentation) so if anyone wants to be involved please let me know! Also I'll have like a billion questions because I have no idea wtf I'm doing so am learning by trying to improve the learning experience....!
@SofieDocs hopefully I'll have stuff to send your way!
s
Love this!
And fire away on questions!
j
General thoughts as I go: - Curious if there should be a more basic version of the Fundamentals/Setup - the Database Account Roles stuff isn't absolutely essential when using the SQLite build (imo)
s
Which docs are you looking at?
It's good to point out that SQLite gives you a quickstart, but we want to be careful to note that SQLite is not a supported database option for production sites. 🙂
j
@SofieDocs what's the best way to get changes to your wonderful self? Right now I'm working on a fork of the main repo, but it keeps adding a bunch of potentially unhelpful files so I don't know if it's better to "only" edit the files on Main?
s
That does look like a strange assortment of files Normally we do recommend working on a local fork 😅 Are all those files committed to your fork as well, or are they just local?
j
Currently they're added to the local fork (as removing them meant adding them to the .gitignore file)
s
😱 Well, that's just super strange. Never seen anything like this before. How are you working locally? Usually, it's easiest to open the entire UmbracoDocs folder in VS Code and then go from there. But if this is too much a pain, you can of course also edit the file directly on GitHub on your own fork 🙈 That should spare us the unwanted files at least... but not the most efficient way of working..
j
OK so I'm doing it in Visual Studio rather than VS Code - SO I'm going to "start again" in VS Code and just copy of these three changes and see what happens. Will update!
[EDIT: Seb says this is a product issue with GitBook] Copy/Pasting from Docs: is there a way to allow just sections of the code snippets to be copy/pasted? For example, if I select this section of code then hit Ctrl+C, I can't paste it. BUT I can copy the entire snippet with the copy button at the top right. Link: https://docs.umbraco.com/umbraco-cms/fundamentals/setup/install/unattended-install
s
Sounds good about VS Code 💪 I don't have any issues copies only parts of the code snippet 😅 So I'm not really sure what to say about that 🤔
j
Code Snippets - OO really?? No way! What browser are you using??
(I'm on Firefox)
AH - try multiple lines - for me, I can only get one line: Here's what I get from copy/pasting the below: ended": true,
s
That is seriously odd! I'm using Chrome and have never had any issues with this 😅
We've just done some testing, and it seems like this is an issue with Firefox 😅 At least according to our tests!
j
OK will try with Chrome - I'll raise an issue on the repo and just say "issue with Firefox". TY!
Copy code
nnectionStrings": {
    "umbracoDbDSN": "Data Source=|DataDirectory|/Umbraco.sqlite.db;Cache=Shared;Foreign Keys=True;Pooling=True",
    "umbracoDbDSN_ProviderName": "Microsoft
Yep, works just fine NOT on Firefox!
Code Snippet stuff - have raised an issue: https://github.com/umbraco/UmbracoDocs/issues/5016
s
Thanks! Not much I can do about it from our end, but I'll escalate it to GitBook right away 🙌
j
Editing docs with VS vs VS Code: - using VS Code only changes the specific file - using VS creates all sorts of random little files Will use VS Code from now on for making changes (maybe worth adding a little note in the README.md file? Will put a draft sentence into the PR)
s
We actually prefer to have our contrib docs on the site itself: https://docs.umbraco.com/welcome/contribute/getting-started So perhaps add a note to the "Creating a PR" article instead? I think that would be a good fit for something like this 💪
j
AH makes sense - cool, will do
4 Views
PreviousNext
Powered by