refactoring

Author: davidhozic

docs/thesis/sl/abstract.rst

@@ -12,40 +12,41 @@
     \chapter*{Povzetek}
 
 
-Nezamenljivi žetoni (angl. *Non fungible tokens*) so edinstvena digitalna sredstva, ki živijo na verigi blokov brez možnosti replikacije.
-Obstaja več pristopov za njihovo oglaševanje, kjer je eden izmed teh oglaševanje po socialnem omrežju Discord s pristopom agresivnega oglaševanja.
-Diplomsko delo se fokusira na proces oglaševanja in se navezuje na projekt Ogrodje za oglaševanje po Discordu (angl. Discord Advertisement Framework),
-ki je implementirano v programskem jeziku Python.
-
-Najprej so v delu opisani nezamenljivi žetoni oziroma pristopi k njihovem oglaševanju.
-Zatem je predstavljeno socialno omrežje Discord in pristop oglaševanja na tem omrežju.
-Sledi predstavitev samega projekta diplomske naloge, kjer je cilj naloge izdelava ogrodja za oglaševanje po Discordu,
+Nezamenljivi žetoni (angl. *Non-fungible tokens*) so edinstvena digitalna sredstva, ki živijo na verigi blokov brez možnosti replikacije.
+Obstaja več pristopov za njihovo oglaševanje, pri čemer je eden izmed teh oglaševanje prek socialnega omrežja Discord, s pristopom agresivnega oglaševanja.
+Diplomsko delo se osredotoča na proces oglaševanja in se nanaša na projekt Ogrodje za oglaševanje prek Discorda (angl. *Discord Advertisement Framework*),
+ki je implementiran v programskem jeziku Python.
+
+Najprej so v delu opisani nezamenljivi žetoni, ter pristopi k njihovemu oglaševanju.
+Nato je predstavljeno socialno omrežje Discord in pristop k oglaševanju na tem omrežju.
+Sledi predstavitev samega projekta diplomske naloge, katerega cilj je izdelava ogrodja za oglaševanje prek Discorda,
 ki lahko deluje samodejno brez posredovanja uporabnika, se ustrezno odziva na napake, nudi beleženje sporočil in je konfigurabilno,
 da lahko deluje na več načinov.
 
-V poglavju vezanem na projekt diplomskega dela so predstavljeni zasnova in razvoj projekta, njegova dokumentacija in avtomatično testiranje.
-
-Ogrodje se na najvišjem nivoju deli na jedro in grafični vmesnik, kjer jedro lahko deluje neprekinjeno na strežniku in
+V poglavju, ki se nanaša na projekt diplomskega dela, so predstavljeni zasnova in razvoj projekta, njegova dokumentacija ter avtomatizirano testiranje.
+Ogrodje se na najvišji ravni deli na jedro in grafični vmesnik, pri čemer lahko jedro deluje neprekinjeno na strežniku ter
 je sposobno na daljavo procesirati ukaze iz grafičnega vmesnika. Oglaševalske podatke in parametre se v jedru
-nastavi kar preko Python skripte / programa, kjer je potrebno minimalno znanje Python jezika.
-Jedro se deli na več sektorjev za lažji razvoj in nadgrajevanje.
-Grafični vmesnik je prav tako implementiran v Pythonu. Opisan je razvoj grafičnega vmesnika,
-opisana je njegova struktura in na koncu je opisan oddaljen dostop do jedra ogrodja.
-Objekte (račune, sporočila, ipd.) se v grafičnem vmesniku definira preko novega okna, ki se samodejno generira na podlagi
-podatkovnih tipov prebranih iz izvorne kode funkcij in razredov v jedru ogrodja. Definirane objekte je mogoče shraniti v JSON datoteko oz.
-omogočeno je tudi generiranje Python oglaševalske skripte, ki deluje v jedru ogrodja.
+nastavi prek Python skripte/programa, pri čemer je potrebno minimalno znanje jezika Python.
+Jedro je razdeljeno na več sektorjev za lažji razvoj in nadgradnjo.
+Grafični vmesnik je prav tako implementiran v jeziku Python. Opisan je razvoj grafičnega vmesnika,
+predstavljena je njegova struktura, na koncu pa je opisan tudi oddaljen dostop do jedra ogrodja.
+Objekte (račune, sporočila, ipd.) je mogoče v grafičnem vmesniku definirati prek novega okna, ki se samodejno generira na podlagi
+podatkovnih tipov, prebranih iz izvorne kode funkcij in razredov v jedru ogrodja. Definirane objekte je mogoče shraniti v JSON datoteko, prav tako
+je omogočeno generiranje Python oglaševalske skripte, ki deluje v jedru ogrodja.
 
-Po opisu razvoja in zasnove jedra ter grafičnega vmesnika ogrodja, je opisan proces dokumentacije.
-Dokumentacija je izdelana s sistemom Sphinx, in se avtomatično gradi in objavlja ob vsaki izdaji projekta
-preko platforme GitHub. Opis vseh javnih razredov in funkcij (programskega vmesnika) se samodejno generira iz same kode projekta.
+Po opisu razvoja in zasnove jedra ter grafičnega vmesnika ogrodja je opisan proces dokumentiranja.
+Dokumentacija je izdelana s sistemom Sphinx in se avtomatično gradi ter objavlja ob vsaki izdaji projekta
+prek platforme GitHub. Opis vseh javnih razredov in funkcij (programskega vmesnika) se samodejno generira iz same kode projekta.
 
-Na koncu poglavja o projektu diplomskega dela je opisan še proces avtomatičnega testiranja, kjer je ta implementiran z ogrodjem za
-avtomatično testiranje pytest. Ogrodje se, ob vsakem zahtevku za združitev vej na GitHubu, avtomatično testira in zavrne združitev veje, če
-katerikoli od testov ne uspe. Z avtomatičnem testiranjem se zmanjšajo možnosti za izdajo nove verzije ogrodja z napakami v delovanju.
+Na koncu poglavja o projektu diplomskega dela je opisano še avtomatizirano testiranje kode,
+ki je implementirano z ogrodjem za avtomatizirano testiranje pytest.
+Ogrodje se na platformi GitHub avtomatično testira ob vsakem zahtevku za združitev veje,
+pri čemer se združitev zavrne, če kateri koli od testov ne uspe.
+Z avtomatiziranim testiranjem se zmanjšajo možnosti za izdajo nove verzije ogrodja z napakami v delovanju.
 
-Zaključim lahko da je ogrodje izjemno uporabno ne le za oglaševanje NFT, a tudi za oglaševanje katere koli druge vsebine.
-Ker v času pisanja ne obstaja skoraj nobeno brezplačno oglaševalsko ogrodje, ki bi bilo sposobno vsega kar je sposobno to ogrodje,
-je smiselno sklepati da je projekt izjemno uporabne narave.
+Sklepam, da je ogrodje izjemno uporabno ne le za oglaševanje NFT, temveč tudi za oglaševanje katere koli druge vsebine.
+Ker v času pisanja skoraj ni na voljo brezplačnega ogrodja za oglaševanje, ki bi bilo sposobno vsega, kar je sposobno to ogrodje,
+je smiselno sklepati, da je projekt izjemno uporabne narave.
 
 
 **Ključne besede:** Python, grafični vmesnik, oddaljen dostop,
@@ -60,9 +61,6 @@ shranjevanje v datoteko, dokumentacija, avtomatično testiranje, beleženje spor
 
     \chapter*{Abstract}
 
-Non-fungible tokens (NFTs) are unique digital assets that exist on a blockchain without the ability of replication.
-There are several approaches of advertising them, one of which is advertising on the social network Discord using the shilling approach.
-The thesis focuses on the advertisement process and relates to the Discord Advertisement Framework project, implemented in the Python programming language.
 
 First, the thesis describes non-fungible tokens and approaches to their advertisement.
 Next, it presents the social network Discord and the advertisement approach on this social network. It also explains the types of user accounts and channel types where advertisement can take place.

docs/thesis/sl/appendix.rst

@@ -47,8 +47,8 @@ Pošiljanje tekstovnega sporočila s periodo naključno med 1 uro in 2 urama, z
 
 
 
-Avtomatsko odkrivanje (angl. discovery) cehov in kanalov
----------------------------------------------------------
+Avtomatsko odkrivanje (angl. *discovery*) cehov in kanalov
+-----------------------------------------------------------
 Pošiljanje s fiksno periodo dveh ur in avtomatično odkrivanje pridruženih cehov in kanalov na podlagi RegEx vzorca.
 
 .. literalinclude:: ./DEP/Examples/example-autoguild-autochannel.py

docs/thesis/sl/daf/design_development/core.rst

@@ -26,7 +26,7 @@ AsyncIO
 ===============
 Jedro ogrodja je zasnovano za sočasno (angl. *concurrent*) večopravilnost, kar pomeni da se lahko na videz več opravil izvaja na enkrat, v
 resnici pa se med njimi zelo hitro preklaplja. To je omogočeno s knjižnico :mod:`asyncio`.
-AsyncIO omogoča ustvarjanje ``async`` funkcij, ki vrnejo korutine (angl. coroutine). Te korutine lahko potem zaženemo v opravilih,
+AsyncIO omogoča ustvarjanje ``async`` funkcij, ki vrnejo korutine (angl. *coroutine*). Te korutine lahko potem zaženemo v opravilih,
 med katerimi bo program preklopil vsakič, ko v trenutnem opravilu z ``await`` besedo na primer čakamo:
 
 - na konec neke asinhrone komunikacije (angl. *Async I/O*)

docs/thesis/sl/discord.rst

@@ -48,8 +48,8 @@ Nekaj primerov Discord skupnosti, povezanih s Univerzo v Ljubljani:
     \newpage
 
 
-Discordova struktura
-======================
+Struktura omrežja Discord
+==========================
 
 Discord aplikacija je v osnovi sestavljena iz gumba za direktna (osebna) sporočila, seznama cehov / strežnikov, seznama kanalov
 in seznama uporabnikov (uporabniških računov), ki so pridruženi v ceh. :ref:`discord_interface`.
@@ -118,9 +118,9 @@ vsiljiv oz. agresiven način prepovedano v Discordovih pogojih uporabe, kar pome
 
 
 
-Oglaševanje po Discordu
-==========================
-Po Discordu se lahko oglašuje širok nabor tem, med katerimi so
+Oglaševanje po omrežju Discord 
+===============================
+Po Discord omrežju se lahko oglašuje širok nabor tem, med katerimi so
 video igre, kreativni projekti, produkti, usluge, ipd. Ne sme pa se oglaševati nelegalnih vsebin oz. vsebin,
 ki spodbujajo kršenje zakona in vsebin, ki bi lahko povzročile škodo posameznikom :ref:`discord_guidelines`.