udexon / DUNIIX

DUNIIX: Decentralized User Centric Interface
1 stars 1 forks source link

Improve README #2

Open Lecrapouille opened 3 years ago

Lecrapouille commented 3 years ago

To help people understanding your idea. You could reorganize the README starting from the main idea and progressively entering inside details. [MY REMARKS]

# DUNIIX: Decentralized User Centric Interface

DUNIIX is an API (framework ?) that allows to [... TO BE COMPLETED] based on two fundamental ideas:
1. Decentralized User Authentication based on public key cryptography. [SSH TUNNEL ?]
2. The use of Phoscript metaprogramming script, derived from the Forth programming language to simplify GUI, web, mobile and back-end programming, so that ___everyone can code___, i.e. User Centric Programming. [POOR SENTENCE: THE PRESENCE OF FORTH WILL NOT MAKE YOUR GUI SIMPLIFIED. DID YOU MEAN FORTH SCRIPT WILL EASILY ALLOW TO GLUE DIFFERENTS API, GUI, WEB ... TOGETHER IN THE SAME WAY THAT PYTHON BUT IN A COMPACT WAY. AFTER I PERSONALY PREFER JULIA OR PYTHON AS GLUE THAN FORTH BECAUSE THEY ARE HIGH LEVEL LANGUAGE (JULIA ALLOWS METAPROGRAMMIG). THE ONLY ADVANTAGE OF FORTH CODE IS TO BE COMPACT AND THEREFORE EASILY SEND INSIDE SOCKETS AND THEREFORE TO BE RUN BY EVERYONE => BUT THIS SOUNDS LIKE A SECURITY FAILURE ABOUT NASTY CODE].

[EXPLAIN HERE WHAT WHITH DUNIIX WE CAN DO AND WHAT OTHER FRAMEWORKS DOES NOT OFFER].

We coined the name DUNIIX to highlight the Decentralized nature of DUNIIX, in contrast to the centralized systems inherited from UNIX. [EXPLAIN HERE WHAT "(DE)CENTRALIZED" MEANS. DO YOU MEAN DISTRIBUTED ? DO YOU MEAN INTERNET OF THINGS ?]. DUNIIX is also very different from Blockchains as we are "User Centric", hence the "U" in DUNIIX. [ 1/ "very different" => EXPLAIN THAT, THIS IS UNCLEAR. INTRODUCE HOW BLOCKCHAINS ARE WORKING. INTRODUCE HOW DUNIIX WORKS. WHAT ARE DIFFERENCES.  2/ YOU SAID as we are "User Centric" BUT THE SENTENCE BEFORE WE ARE DECENTRALIZED. THIS SOUNDS IN CONTRADICTION. 3/ HOW BLOCKCHAINS ARE WORKING. 2/ "very different" ]

[AFTER READING THIS, I'M ASKING MYSELF: WHAT IS THE DIFFERENCE BETWEEN DUNIIX AND SSH ? DUNIIX WITH PEER TO PEER TORRENTS. WHY WILL I USE YOUR FRAMEWORK INSTEAD OF MQTT ?]

[ADD HERE THE TABLE OF CONTENTS TO OTHER MD FILES + WITH EXPLANATIONS]

[MOVE THIS SENTENCE AT THE END OF THE DOCUMENT.]

The double I is used to avoid conflicts with existing DUNIX entities, as well as to signify II — the Roman Numeral 2 — for a new generation. Finally IIX in Roman Numerals is 8, a lucky number in Chinese.

[YOU SPENT 2 LINES TO EXPLAIN YOUR PROJECT NAME BUT 0 LINE TO WHAT YOUR FRAMEWORK IS WORKING. SO HERE PEOPLE STILL HAVE NO CLUE ON HOW THIS WORKING].
Lecrapouille commented 3 years ago

Instagram_Following.md.

You cannot start this document by "We reserve ..." please introduce what this tutorial will acheive, so add something like this "In this document, we will show how DUNIIX is used to achieve .... [to be completed. Maybe cracking the profile of your idol lol I did not get the point of your idea]"

Your bulleted list is very hard to understand. Try to organize your ideas steps by steps. I'm lost after "Figure 1 shows the "Following" floating window ..." since you did not explain what you are going to do, so we do not know if this figure is the final objective or just a step to follow.

Note: since I'm a boomer I've never been on Instagram I do not know what is "the following" window. Is this a popup made by instagram or by DUNIIX ? A pedagogic tutorial shall be abstract of the technology.

The bullet referring to python script. What is is this ? Shall we have to execute it ? to edit it ? to add to it the html code ? By the way why Python ? What about Phoscript ?

"classname "FPmhX"" => What is that ? "executed in Python interactive mode together with chromedriver" => what is chromedriver is the DOM which called Python script ?

Idem for the json file and other line.

Please end your tutorial by a conclusion "in this document we have shown how to crack the instagram profile ..."

Is this tutorial trying to explain the python code ? Why this python code has no comments ? What is BeautifulSoup ?

Lecrapouille commented 3 years ago

All work and no play makes Jack a dull boy,