muctadir / lama Goto Github PK
View Code? Open in Web Editor NEWLaMa, short for Labelling Machine, is an web application developed for aiding in thematic analysis of qualitative data.
License: MIT License
LaMa, short for Labelling Machine, is an web application developed for aiding in thematic analysis of qualitative data.
License: MIT License
In general, when there is no content to display, it is better to show a message explaining this and possibly some additional action for the user to help avoid confusion or an impression that content is failing to load.
Examples:
Submitted while reviewing openjournals/joss-reviews#5135
In many areas of the application's layout, it is set such that the contents of the page will go as wide as the page width. particularly when dealing with, say, an ultrawide monitor, this makes it difficult to follow the contents of the page as it hurts things like visual grouping of fields and action buttons and generally hurts the ability to scan the content of the page (having to find small pieces of content in widely separated parts of the screen, reading very short content in very wide fields, text going wider than ~70-80 characters, etc). In many cases, there should likely be maximum widths added either to the entire page layout or specific components of the page (eg, even if you cap the width of all pages, the username and email fields on the account creation screen should be much shorter)
Submitted while reviewing openjournals/joss-reviews#5135
The docker setup is very straight forward (kudos!) but there doesn't seem to be clear documentation beyond software requirements for getting set up for development (what commands am I expected to run? how can I run things with hot reloading? etc).
Related: Following the instructions provided in the README is not sufficient for running tests successfully. You need to install the python requirements via pip to run the backend tests, and even after installing the frontend requirements via npm and setting my chrome binary, no tests were found.
Submitted while reviewing openjournals/joss-reviews#5135
It would probably be more intuitive to have more consistency in the navigation structure. Namely:
Submitted while reviewing openjournals/joss-reviews#5135
Currently when going to your account settings, you get a view-only mode and have to additionally click an edit button. Is this necessary? Most sites I'm aware of directly send you to an editable page.
Submitted while reviewing openjournals/joss-reviews#5135
Currently I'm a little confused about the scope of what is being submitted to JOSS within the context of the previous versions of the application. Namely:
This may warrant some clarification in the paper itself, though I'm not sure if that's necessary (maybe worth checking with the editor?)
Submitted while reviewing openjournals/joss-reviews#5135
Hi,
Part of openjournals/joss-reviews#5135, I checked out the code, and noticed a package-lock.json
in the source directory. I think that file is normally generated from a package.json
, and, normally, is stored in the same directory as that file.
Is there a reason for having that file in the root source directory, instead of, having that only in the frontend directory?
Cheers,
-Bruno
Hi,
Related to openjournals/joss-reviews#5135; the Linux command in the README.md
file doesn't work when pasted in the command-line. I've submitted a quick PR for that, see #8
However, running the command I get:
Please run with privilege
Looking at the sources, it runs docker-compose --env-file .env -f Docker/docker-compose.yml up --build -d
.
If I modify the command, and use docker compose
instead, that runs fine on my computer without the need of root access (I did that step to run it rootless).
The script also appears to have some logic to ask the user the operating system,
echo "What operating system are you running?"
echo "1) Windows"
echo "2) Linux"
read -p 'Boot option: ' os
if [[ $os != 2 ]]
then
echo "You gave an invalid option for the OS (either not 1/2 or Windows)."
echo "Try again by reopening the file. Goodbye for now!"
exit
fi
That doesn't look useful as there are two scripts, one of Linux and one for Windows. There could also be MacOS users that could not be sure which version to choose.
IMHO, it'd be easier to just list the docker compose command, and leave the operating system out. Or re-write the installation process to simplify it, and make sure the docs work for users on Linux and/or the possible issues & variations of commands are documented (e.g. maybe say "if you have docker compose, you can run this command... if you have not configured it as rootless you may need to use sudo
, etc..").
Cheers
-Bruno
I imagine in many installations, admins would want to only allow specific individuals to create accounts. It should probably be possible to turn off public account creation in favor of just sending email invites to provision new accounts.
Submitted while reviewing openjournals/joss-reviews#5135
There are a number of instances where buttons don't look clickable (eg the add members and create label buttons), as well as text that looks like links but are not (eg the project stats and user stats headers)
Submitted while reviewing openjournals/joss-reviews#5135
There are a number of instances where obscure errors are presented to the user where it is unclear what the issue was and how the user could correct it. EG:
Related: It should be made clear when fields are required when it isn't obvious, and if a particular format is required (eg specific password validation rules) that should be given up front.
Additionally, errors should ideally be shown directly next to fields they're related to, if applicable
Submitted while reviewing openjournals/joss-reviews#5135
Hi,
I am reviewing your JOSS paper ๐ openjournals/joss-reviews#5135
JOSS has a list of requirements for the paper. This issue is about this one:
Community guidelines: Are there clear guidelines for third parties wishing to 1) Contribute to the software 2) Report issues or problems with the software 3) Seek support
It's common for projects hosted at GitHub to contain a CONTRIBUTING.md
file, e.g. https://docs.github.com/en/communities/setting-up-your-project-for-healthy-contributions/setting-guidelines-for-repository-contributors
Your repository doesn't seem to contain that file, and the README
is also missing that. Maybe that file could contain the instructions for running & test docs, or the README file could be extended...
Note that the README has a Contributions entry that's confusing too, in the table of contents. Maybe that could be renamed to Acknowledgements, to match the title used.
Cheers,
-Bruno
Hi,
Related to openjournals/joss-reviews#5135, the item
Automated tests: Are there automated tests or manual steps described so that the functionality of the software can be verified?
Looks like GH Actions is only building the PDF at the moment? Any plans to add tests to the frontend and to the backend, and run them automatically on GH Actions?
Hi,
Part of openjournals/joss-reviews#5135. I see you mentioned commercial tools in the statement of need of the JOSS paper. The first item in your list of trade offs is the cost. However, that statement of need seems to ignore the existence of other OSS tools that could be compared to LaMa.
Could you consider adding other OSS tools, please? For example:
Cheers,
-Bruno
A declarative, efficient, and flexible JavaScript library for building user interfaces.
๐ Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.
TypeScript is a superset of JavaScript that compiles to clean JavaScript output.
An Open Source Machine Learning Framework for Everyone
The Web framework for perfectionists with deadlines.
A PHP framework for web artisans
Bring data to life with SVG, Canvas and HTML. ๐๐๐
JavaScript (JS) is a lightweight interpreted programming language with first-class functions.
Some thing interesting about web. New door for the world.
A server is a program made to process requests and deliver data to clients.
Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.
Some thing interesting about visualization, use data art
Some thing interesting about game, make everyone happy.
We are working to build community through open source technology. NB: members must have two-factor auth.
Open source projects and samples from Microsoft.
Google โค๏ธ Open Source for everyone.
Alibaba Open Source for everyone
Data-Driven Documents codes.
China tencent open source team.