Re-arrange things in db module section

Author: vejol

src/content/3/en/part3c.md

@@ -428,8 +428,7 @@ mongoose.set('strictQuery', false)
 
 const url = process.env.MONGODB_URI // highlight-line
 
-console.log('connecting to', url) // highlight-line
-
+console.log('connecting to', url)
 mongoose.connect(url)
 // highlight-start
   .then(result => {
@@ -456,17 +455,19 @@ noteSchema.set('toJSON', {
 module.exports = mongoose.model('Note', noteSchema) // highlight-line
 ```
 
-Defining Node [modules](https://nodejs.org/docs/latest-v18.x/api/modules.html) differs slightly from the way of defining [ES6 modules](/en/part2/rendering_a_collection_modules#refactoring-modules) in part 2.
+There are some changes in the code compared to before. The database connection URL is now passed to the application via the MONGODB_URI environment variable, as hardcoding it into the application is not a good idea:
 
-The public interface of the module is defined by setting a value to the _module.exports_ variable. We will set the value to be the <i>Note</i> model. The other things defined inside of the module, like the variables _mongoose_ and _url_ will not be accessible or visible to users of the module.
+```js
+const url = process.env.MONGODB_URI
+```
 
-Importing the module happens by adding the following line to <i>index.js</i>:
+There are many ways to define the value of an environment variable. For example, we can define it when starting the application as follows:
 
-```js
-const Note = require('./models/note')
+```bash
+MONGODB_URI="your_connection_string_here" npm run dev
 ```
 
-This way the _Note_ variable will be assigned to the same object that the module defines.
+We will soon learn a more sophisticated way to define environment variables.
 
 The way that the connection is made has changed slightly:
 
@@ -484,21 +485,22 @@ The method for establishing the connection is now given functions for dealing wi
 
 ![node output when wrong username/password](../../images/3/45e.png)
 
-It's also not a good idea to hardcode the address of the database into the code, so the url is obtained differently: the address of the database is passed to the application via the <em>MONGODB_URI</em> environment variable:
 
-```js
-const url = process.env.MONGODB_URI
+Defining Node [modules](https://nodejs.org/docs/latest-v18.x/api/modules.html) differs slightly from the way of defining [ES6 modules](/en/part2/rendering_a_collection_modules#refactoring-modules) in part 2.
 
-console.log('connecting to', url)
-```
+The public interface of the module is defined by setting a value to the _module.exports_ variable. We will set the value to be the <i>Note</i> model. The other things defined inside of the module, like the variables _mongoose_ and _url_ will not be accessible or visible to users of the module.
 
-There are many ways to define the value of an environment variable. One way would be to define it when the application is started:
+Importing the module happens by adding the following line to <i>index.js</i>:
 
-```bash
-MONGODB_URI=address_here npm run dev
+```js
+const Note = require('./models/note')
 ```
 
-A more sophisticated way is to use the [dotenv](https://github.com/motdotla/dotenv#readme) library. You can install the library with the command:
+This way the _Note_ variable will be assigned to the same object that the module defines.
+
+### Defining environment variables using the dotenv library
+
+A more sophisticated way to define environment variables is to use the [dotenv](https://github.com/motdotla/dotenv#readme) library. You can install the library with the command:
 
 ```bash
 npm install dotenv
@@ -524,7 +526,7 @@ Let's load the environment variables at the beginning of the index.js file so th
 ```js
 require('dotenv').config() // highlight-line
 const express = require('express')
-const Note = require('./models/note')
+const Note = require('./models/note') // highlight-line
 
 const app = express()
 // ..
@@ -537,9 +539,9 @@ app.listen(PORT, () => {
 
 It's important that <i>dotenv</i> gets imported before the <i>note</i> model is imported. This ensures that the environment variables from the <i>.env</i> file are available globally before the code from the other modules is imported.
 
-### Important note about environment variables
+#### Important note about defining environment variables in Fly.io and Render
 
-Because GitHub is not used with Fly.io, the file .env also gets to the Fly.io servers when the app is deployed. Because of this, the env variables defined in the file will be available there.
+**Fly.io users:** Because GitHub is not used with Fly.io, the file .env also gets to the Fly.io servers when the app is deployed. Because of this, the env variables defined in the file will be available there.
 
 However, a [better option](https://community.fly.io/t/clarification-on-environment-variables/6309) is to prevent .env from being copied to Fly.io by creating in the project root the file _.dockerignore_, with the following contents
 
@@ -553,7 +555,7 @@ and set the env value from the command line with the command:
 fly secrets set MONGODB_URI="mongodb+srv://fullstack:[email protected]/noteApp?retryWrites=true&w=majority&appName=Cluster0"
 ```
 
-When using Render, the database url is given by defining the proper env in the dashboard:
+**Render users:** When using Render, the database url is given by defining the proper env in the dashboard:
 
 ![browser showing render environment variables](../../images/3/render-env.png)
 

src/content/3/fi/osa3c.md

@@ -422,7 +422,7 @@ mongoose.set('strictQuery', false)
 
 const url = process.env.MONGODB_URI // highlight-line
 
-console.log('connecting to', url) // highlight-line
+console.log('connecting to', url)
 mongoose.connect(url)
   // highlight-start
   .then(result => {
@@ -449,17 +449,19 @@ noteSchema.set('toJSON', {
 module.exports = mongoose.model('Note', noteSchema) // highlight-line
 ```
 
-Noden [moduulien](https://nodejs.org/docs/latest-v8.x/api/modules.html) määrittely poikkeaa hiukan osassa 2 määrittelemistämme frontendin käyttämistä [ES6-moduuleista](/osa2/kokoelmien_renderointi_ja_moduulit#refaktorointia-moduulit).
+Koodissa on jonkin verran muutoksia aiempaan. Tietokannan yhteysosoite välitetään sovellukselle nyt MONGODB_URI ympäristömuuttujan kautta, koska sen kovakoodaaminen sovellukseen ei ole järkevää:
 
-Moduulin ulos näkyvä osa määritellään asettamalla arvo muuttujalle _module.exports_. Asetamme arvoksi modelin <i>Note</i>. Muut moduulin sisällä määritellyt asiat, esim. muuttujat _mongoose_ ja _url_ eivät näy moduulin käyttäjälle.
+```js
+const url = process.env.MONGODB_URI
+```
 
-Moduulin käyttöönotto tapahtuu lisäämällä tiedostoon <i>index.js</i> seuraava rivi:
+On useita tapoja määritellä ympäristömuuttujan arvo. Voimme esim. antaa sen ohjelman käynnistyksen yhteydessä seuraavasti:
 
-```js
-const Note = require('./models/note')
+```bash
+MONGODB_URI="osoite_tahan" npm run dev
 ```
 
-Näin muuttuja _Note_ saa arvokseen saman olion, jonka moduuli määrittelee.
+Opettelemme pian kehittyneemmän tavan määritellä ympäristömuuttujia.
 
 Yhteyden muodostustavassa on pieni muutos aiempaan:
 
@@ -477,27 +479,27 @@ Yhteyden muodostavalle metodille on nyt rekisteröity onnistuneen ja epäonnistu
 
 ![Konsoliin tulostuu virheilmoitus 'error connecting to Mongo, bad auth'](../../images/3/45e.png)
 
-Ei ole myöskään hyvä idea kovakoodata tietokannan osoitetta koodiin, joten tietokannan osoite välitetään sovellukselle <em>MONGODB_URI</em> ympäristömuuttujan kautta:
+Noden [moduulien](https://nodejs.org/docs/latest-v8.x/api/modules.html) määrittely poikkeaa hiukan osassa 2 määrittelemistämme frontendin käyttämistä [ES6-moduuleista](/osa2/kokoelmien_renderointi_ja_moduulit#refaktorointia-moduulit).
+
+Moduulin ulos näkyvä osa määritellään asettamalla arvo muuttujalle _module.exports_. Asetamme arvoksi modelin <i>Note</i>. Muut moduulin sisällä määritellyt asiat, esim. muuttujat _mongoose_ ja _url_ eivät näy moduulin käyttäjälle.
 
-```js
-const url = process.env.MONGODB_URI
+Moduulin käyttöönotto tapahtuu lisäämällä tiedostoon <i>index.js</i> seuraava rivi:
 
-console.log('connecting to', url)
+```js
+const Note = require('./models/note')
 ```
 
-On useita tapoja määritellä ympäristömuuttujan arvo. Voimme esim. antaa sen ohjelman käynnistyksen yhteydessä seuraavasti:
+Näin muuttuja _Note_ saa arvokseen saman olion, jonka moduuli määrittelee.
 
-```bash
-MONGODB_URI=osoite_tahan npm run dev
-```
+### Ympäristömuuttujien määritteleminen käyttäen dotenv-kirjastoa
 
-Eräs kehittyneempi tapa on käyttää [dotenv](https://github.com/motdotla/dotenv#readme)-kirjastoa. Asennetaan kirjasto komennolla
+Eräs kehittyneempi tapa ympäristömuuttujien määrittelemiseen on käyttää [dotenv](https://github.com/motdotla/dotenv#readme)-kirjastoa. Asennetaan kirjasto komennolla
 
 ```bash
 npm install dotenv
 ```
 
-Sovelluksen juurihakemistoon tehdään sitten tiedosto nimeltään <i>.env</i>, jonne tarvittavien ympäristömuuttujien arvot määritellään. Tiedosto näyttää seuraavalta:
+Luodaan sitten sovelluksen juurihakemistoon tiedosto nimeltään <i>.env</i>, jonne tarvittavien ympäristömuuttujien arvot määritellään. Tiedosto näyttää seuraavalta:
 
 ```bash
 MONGODB_URI=mongodb+srv://fullstack:[email protected]/noteApp?retryWrites=true&w=majority&appName=Cluster0
@@ -519,7 +521,7 @@ Ladataan ympäristömuuttujat käyttöön heti <i>index.js</i>-tiedoston alussa,
 ```js
 require('dotenv').config() // highlight-line
 const express = require('express')
-const Note = require('./models/note')
+const Note = require('./models/note') // highlight-line
 
 const app = express()
 // ..
@@ -532,9 +534,9 @@ app.listen(PORT, () => {
 
 On tärkeää, että <i>dotenv</i> otetaan käyttöön ennen modelin <i>note</i> importtaamista. Tällöin varmistutaan siitä, että tiedostossa <i>.env</i> olevat ympäristömuuttujat ovat alustettuja kun moduulin koodia importoidaan.
 
-### Tärkeä huomio ympäristömuuttujista 
+#### Tärkeä huomio ympäristömuuttujien määrittelemisestä Fly.io:ssa ja Renderissä
 
-Koska Fly.io ei hyödynnä gitiä, menee myös .env-tiedosto Fly.io:n palvelimelle, ja ympäristömuuttujien arvo välittyy myös sinne.
+**Fly.io:n käyttäjät:** Koska Fly.io ei hyödynnä gitiä, menee myös .env-tiedosto Fly.io:n palvelimelle, ja ympäristömuuttujien arvo välittyy myös sinne.
 
 [Tietoturvallisempi vaihtoehto](https://community.fly.io/t/clarification-on-environment-variables/6309) on kuitenkin estää tiedoston .env siirtyminen Fly.io:n tekemällä hakemiston juureen tiedosto _.dockerignore_, jolla on sisältö
 
@@ -548,7 +550,7 @@ ja asettaa ympäristömuuttujan arvo komennolla:
 fly secrets set MONGODB_URI='mongodb+srv://fullstack:[email protected]/noteApp?retryWrites=true&w=majority&appName=Cluster0'
 ```
 
-Renderiä käytettäessä tietokannan osoitteen kertova ympäristömuuttuja määritellään dashboardista käsin:
+**Renderin käyttäjät:** Renderiä käytettäessä tietokannan osoitteen kertova ympäristömuuttuja määritellään dashboardista käsin:
 
 ![](../../images/3/render-env.png)