Kasutaja arutelu:Yootah/Üheleherakendus
Tänan sisuka ja hästi kirjutatud artikli eest! Lisan mõne kommentaari. Neid võib tunduda olevat palju, aga neist enamik käivad pisikeste asjade kohta.
- Ilmselt on artikli suurim murekoht, et palju tekstiosi on viiteta. Viide peab olema vähemalt iga lõigu lõpus ja ka ühegi üksiku lause puhul ei tohi tekkida küsimust, kust see pärineb. Mõistan, et oled aluseks võtnud ingliskeelse artikli ja seal on mõni viide puudu, aga ehk leiad praegu viiteta olevatele tekstiosadele muud allikad.
- Kuna märgid ingliskeelseid sõnu kaldkirjas, siis soovitan sul juhul, kui eesti keeles on vaja midagi sarnaselt esile tõsta, kasutada jutumärke. Niisiis oleks mulle silma jäänud koht järgmine: „Termini „üheleherakendus“ (single-page application) päritolu pole kindel…“
- Palun ühtlusta ka ingliskeelsete sõnade kirjutamine: kas kõik väikeste või kõik (v.a artiklid, eessõnad jne) suurte algustähtedega.
- Kui HTML-elementidel on nimed (iframe ja script), ei peaks need kaldkirjas olema. Kui kuskil pole nõutud teisiti, võiksid need sel juhul olla märgitud suure tähega.
- Kontrolli siselingid üle: praegu nägin, et JavaScripti siselinki oli mitu korda. Siselink peaks olema pandud sõnale ainult selle esimesel esinemisel.
- Oled enamasti käänanud JavaScripti õigesti. Küll aga on ühes kohas jäänud ülakoma (JavaScript’i), mis ei ole vajalik.
- Sellega seoses: „WebSockets tehnoloogia“ -> „WebSocketsi tehnoloogia“.
- Välislinke ei tohiks teksti sees olla (vrd praegu Aurelia koduleht). Kui soovid Vikipeediast väljas asuvale lehele viidata, võid selleks teha artikli lõppu eraldi alajaotuse „Välislingid“. Selle kohta on rohkem kirjas siin.
- Väldi artiklis hinnanguid: praegu mõjub pisut hinnangulisena esimeses lõigus olev „parem kasutajakogemus“. Jää siiski kirjelduste juurde.
- Püüa vältida sõna „vastavalt“ kasutust ebasoovitavas tähenduses. Vaata lähemalt ÕS-ist.
- „…kuigi erinevate tööriistadega, näiteks HTML5 History API“ – „kuigi eri tööriistade, näiteks HTML5 History APIga…“ Kas mõte jäi muutes õigeks? Kui nii, siis soovitan sul sellist lausestruktuuri kasutada.
- Võib-olla on asi minus, kuna ma ei ole ekspert, aga mida tähendab „(stunix)“ nimes Stuart (stunix) Morris? Kas seda on võimalik kuidagi selgemalt märkida ja pärisnimest paremini eristada?
- Soovitan sul peatüki „Tehnikad“ loetelu eest sõna „Näiteks:“ ära võtta. Siis võib loetelu samale kujule jääda. Vaata lähemalt EKI loetelu vormistamise juhendist.
- HTML elementidega -> HTML-i elementidega / HTML-elementidega
- „klient-server suhtluse“ -> „kliendi-serveri suhtluse“.
- „…veebibrauserites saab kasutada JavaScripti nii kasutajaliidese kuvamiseks, rakenduse loogika jooksutamiseks, kui ka suhtluseks veebiserveriga“ – seal ei käi „kui ka“ ette koma.
- Ühtlusta, kas viitenumbrite ees on tühik või mitte.
Kui oled kommentaaride põhjal parandused teinud, anna palun siinsamas arutelulehel teada. Edu!
---
Õppeassistent --Kairijan (arutelu) 12. november 2018, kell 23:50 (EET)
--- Meile anti tagasiside olemasolust alles sel nädalal teada, seepärast vabandan hilise esituse eest. Viisin sisse parandused, järgides väljatoodud õigekirja- ja stiilisoovitusi. Lisasin viiteid. Kuna üheleherakendus on pigem "hea praktika" kui ametlik standard, siis on sellele raske leida materjale, mis poleks blogipostitused või veebiartiklid. "stunix" on ilmselt mingisugune tolle inimese veebis kasutatav alias. Arendajatel on vahel kombeks neid oma publikatsioonides pseudonüümina kasutada. Võin selle ka välja jätta, kui tundub üleliigne.
---
Tänan paranduste eest!
- Minu arvates võiks aliase tõesti välja jätta, kui inimese pärisnimi on teada.
- Kui kasutad lause jätkuna sõna „mis“, „mida“ vms, peaks see siin vahetult järgnema sõnale, mille kohta ta käib (Nt "kontsert, mis toimus eile, läks hästi". Palun paranda sellest lähtudes lause „React eeldab omaette programmeerimiskeele kasutust, mis on sisuliselt JavaScripti ja HTMLi segu.“ (kui ma õigesti aru saan, siis programmikeel on see „mis“, mis on nende kahe segu?)
- Kui artiklil on autor, peaks ka see viidetes märgitud olema. Peaksid kindlasti viitamisreeglitega tutvuma, seal on täpselt kirjas, millised osad ühel viitel olema peavad.
Kui oled need muudatused teinud, võid artikli põhiruumi laadida. Juhend selleks on siin. Siis on töö arvestatud!
Õppeassistent Kairijan (arutelu) 1. detsember 2018, kell 10:53 (EET)