Hey Team,
So over these few days, I have been looking at the things which we need to follow and things related to the organization that we follow.
So as mentioned in my proposal in the first phase our most important target is to get the base project page up and running including all the perks like Responsiveness, i18n, lining, modern programming techniques for scss, and more. This is primarily the boilerplate stuff which is the first task of this specific project.
So, after exploring the options like Hugo, Next.js, Gatsby.js, CRA, etc, I concluded to use Next.js
The reason to go with is basically react, features like SSG, SEO, and the ability to add basic APIs, and its fast
Plus its react so it will make the work much easier and more flexible. The boilerplate by default supports scss out of the box and also has base support of eslint (We can integrate any flavor of eslint we want, I prefer Airbnb-lint tough). Moreover, the i18n support is also good for react so that's a plus point.
So once we set up this boilerplate, I can start working on the UI part of the site, where we will start with the home page including all of its components which will be reusable and adaptable depending on what we want them to do.
Please share your ideas and views on this
CC @Amanjot Singh @Erik
This is the design reference I made for the project
https://www.figma.com/file/nI1IDdPUHRr2vzBNOLIr60/BRL-CAD-Wireframe?node-id=0%3A1
we cannot say it is complete but it is enough to get us full direction towards the frontend part and thus we will be updating shadows colors and more during the development phase.
neat, but what about support for the oddballs who run noscript and the like? will there be 'graceful degradation'?
Not sure what we are referring to as oddballs
But if we are talking about the components like gallery, wiki
Cause i have been thinking about these 2 parts as well so for those i was thinking that the best solution could be to use subdomain like gallery.brl-cad.org and wiki.brl-cad.org
The thing is i am not completely sure about the structure of the things which are being used or not
For example i am sure about the main page in web repository under brl-cad
But that repo have this wp directory which i am not sure about what its for, like are we using it at all,
There is also this wiki directory there and a repo with name of wiki
So i am just figuring out what is being used where, so that we might also get some things cleaned up for better code management
If you can detail me with these things that would be great
Erik means people like me, who have scripting (i.e. JavaScript) deactivated by default in their browser. With this, I'm seeing an empty page, when I open your reference design link. Hopefully, this won't be the case with the final BRL-CAD site :wink:
This is interesting, I had no idea that developers disable javascript on a permanent basis
So to answer the question is https://static-tweet.vercel.app/
This is a static site made using nextjs and I just tried it with disabling js and its working
So no it won't affect noscript team
There might be few degradations for them at some point which I am not sure of but on a basic level they would be able to access the site
Switching JavaScript off is a precaution when navigating to unknown websites, e.g. from Google search. For example, NoScipt (a Firefox plug-in) lets you select trusted websites where JavaScript is allowed, on every other site it's switched off.
Sounds like a good security precaution
Thanks for the explanation :grinning_face_with_smiling_eyes:
Degradations are normal, but people should be able to see what's the site about, and if they want to "risk" switching JavaScript on ;)
Yeah, from some of the blogs I just read I conclude that there might be some buttons that are completely dependent on JS and might not work but overall the site would be able to display maximum content we want
@Divyanshu Garg please update https://brlcad.org/wiki/Google_Summer_of_Code/2022 with your project when you can, and check over the checklist for other getting-started tasks
@Sean I have added the information
I will be updating it more
Update - I have been working on the boiler plate on local to check what type of configuration would be best for us
Hey @Erik @Amanjot Singh
So I was wondering about the way we are deploying the projects like main site, gallery and wiki on the domain.
Can you please explain a bit about it how its working?
I think manually? it'd be cool to have (semi) automated deployment
on a cloud server like aws or azure?
no, a colo'd fbsd box
Yeah, I think i need to google this one first to understand what it is :sweat_smile:
dedicated hw in a datacenter, running the freebsd operating system
https://www.freebsd.org/
Oh okay
Or, with other words, the machine where brlcad.org runs :wink:
Yeah, I have learned about automated CI/CD with servers like Azure, AWS, or google cloud, so there should be a workaround with FreeBSD as its also Unix-based so maybe we can get not full but at least partial automated deployment
@Divyanshu Garg have you made a decision on what tech stack you will be using for the website?
Yes Sir,
I have decided to use Next.js with a static rendering feature, to get a fast compressed site with good lighthouse performance and also for NoScript users.
For additional details, I will be including Eslint, i18n, Commit lint, and SCSS in the boilerplate. I won't be using any CSS framework or library because I just don't like using any of them and it helps maintain code size.
Please let me know if you have more questions regarding boilerplate setup
That sounds like a plan, Divyanshu. Hit me up when you set up the boilerplate, I would love to help if you need it as well.
Yeah sure, I worked on a test boilerplate but I ended up messing a lot of code in it, So I will be setting up a new one and keeping it clean to start the work
coooool
Hey @Erik @Amanjot Singh
I was importing the boilerplate code to the repo code and I found that the code inside the repo is not the one deployed
Am I looking at the right repo? https://github.com/BRL-CAD/web
Or should I create a new one? (Specifically for nextjs web project)
Because pasting the boilerplate code directly won't be a good idea because a lot of files might get mixed, so maybe we can save it inside a folder in the repo or a separate repo will solve the issue
Just deployed the first empty preview for the boilerplate
https://brl-cad-web.vercel.app/
For now, it just says Project site
Divyanshu Garg said:
Hey Erik Amanjot Singh
I was importing the boilerplate code to the repo code and I found that the code inside the repo is not the one deployed
Am I looking at the right repo? https://github.com/BRL-CAD/web
Or should I create a new one? (Specifically for nextjs web project)
Because pasting the boilerplate code directly won't be a good idea because a lot of files might get mixed, so maybe we can save it inside a folder in the repo or a separate repo will solve the issue
Yes, I second the solution. You can create a new repo for the next version of our application website and keep it separate which you already did. Once we are done with the development. You can even transfer the repo to BRL-CAD.
Though we should wait for the confirmation from @Erik as well. For now I believe it's good to go.
new repo sounds good to me, we just need to make sure to note the location of the new one in the readme of the old one when switching
Yeah, I will update the old readme and make sure to document rules and setup related stuff in the new one
Thanks for the confirmation :grinning_face_with_smiling_eyes:
https://github.com/BRL-CAD/web/pull/64
A pr to update readme.md to let user know about new project
I will be adding tasks here
https://github.com/divyanshugarg36/brl-cad-web/projects/1
https://github.com/divyanshugarg36/brl-cad-web/pull/1
@Amanjot Singh @Erik I have just submitted the first PR for the project please have a look when possible :grinning_face_with_smiling_eyes:
Happy coding!!
The deployment previews are also there
won't matter a lot RN but will help in future PRs
Sent a WIP PR for next update
https://github.com/divyanshugarg36/brl-cad-web/pull/2
Great job @Divyanshu Garg !!
I have reviewed the first PR of the project and approved it. However, I had some thoughts about the second one. I noticed its current work status in progress but its pipeline is failing. You can wait for the commit until the pipeline issues are resolved. Having all the commits green from pipeline status is good practice. I also have some other reviews for PR 2. Let me know when you make it ready for review.
Divyanshu Garg said:
I will be adding tasks here
https://github.com/divyanshugarg36/brl-cad-web/projects/1
You can open issues in projects for the feature you are working on. For instance, you create PR for helper mixins and functions in scss. If we would have an issue with that PR we can discuss the task there, instead of taking the conversation to the PR comments. It can even help you to manage your Kanban board more efficiently and you can link the issues with the project board directly :wink:
Thanks for the review @Amanjot Singh
Yeah I will make the issues and attach the PR to it
made another commit but keeping it wip for now
Hey @Erik @Amanjot Singh
Please do check the deploy preview of the latest commit and share your reviews
https://github.com/divyanshugarg36/brl-cad-web/pull/2
@Divyanshu Garg I have added some comments for PR 2. Can you resolve them? That's okay if you don't make this change in the current code but keeping that code change request for future can help reducing code for sure.
Update: Working on PR review and footer
Hey @Sean @Erik @Amanjot Singh
Since I started working on this project I have been thinking about a lot of things that we can possibly do with the project
And today I was looking at some offsite components of the current implementation and found out that Our gallery has some UI issues and looks outdated
So I was thinking about upgrading it to the latest version and possibly blending it in to match with the primary project, in terms of visualization
I also have some ideas flowing in my head like adding dark mode support, Animations, and SEO-specific improvements
can we add these features after the July deadline so we can cover all these things easily and add more details to the project?
Please share your views...
Update: Footer code is almost done and will be pushing It tomorrow as its little bit messy right now
Hey @Erik @Amanjot Singh
New PR on the line https://github.com/divyanshugarg36/brl-cad-web/pull/3
Please review when possible and share your views
Latest preview
https://brl-cad-web-git-footer-divyanshugarg36.vercel.app/
Divyanshu Garg said:
Hey Sean Erik Amanjot Singh
Since I started working on this project I have been thinking about a lot of things that we can possibly do with the project
And today I was looking at some offsite components of the current implementation and found out that Our gallery has some UI issues and looks outdated
So I was thinking about upgrading it to the latest version and possibly blending it in to match with the primary project, in terms of visualizationI also have some ideas flowing in my head like adding dark mode support, Animations, and SEO-specific improvements
can we add these features after the July deadline so we can cover all these things easily and add more details to the project?
Please share your views...
That sounds awesome. Good to see you pitching ideas to make the website perfect according to our requirements. Having dark mode, animations and SEO is definitely gonna make a good impact on the application. Though I'm not sure about when we can do that, probably after the current timeline of the project. Also, @Sean can confirm if we need to add any other feature to the website that might have higher priority.
cc: @Daniel Rossberg
Divyanshu Garg said:
Hey Erik Amanjot Singh
New PR on the line https://github.com/divyanshugarg36/brl-cad-web/pull/3
Please review when possible and share your views
Okay, I will review this one later this week. I will be a little busy this week so my availability will be limited. If it is possible you can chain this branch and work ahead. Let me know if anything blocks you.
Divyanshu Garg said:
Latest preview
https://brl-cad-web-git-footer-divyanshugarg36.vercel.app/
Looks good, though there are some minor improvements in the mobile view that can be done. It seems like it is in progress if I make a guess, or you can confirm. Also, I feel if the menu in mobile view can have a little modern view it will add good value to the UI.
Okay @Amanjot Singh I will keep pushing and chaining the code
For mobile view navigation, we can do update it to some extent but for now, I am targeting a full web coverage so that we can update the project asap and then we can make the updates that will make it look better
New PR on the line
https://github.com/divyanshugarg36/brl-cad-web/pull/8
wow, I'd not seen vercel before -- that's awesome. loving the live preview feature. that's a huge help!
Divyanshu Garg said:
Hey Sean Erik Amanjot Singh
Since I started working on this project I have been thinking about a lot of things that we can possibly do with the project
And today I was looking at some offsite components of the current implementation and found out that Our gallery has some UI issues and looks outdated
So I was thinking about upgrading it to the latest version and possibly blending it in to match with the primary project, in terms of visualization
Getting the image gallery to match the style and be more integrated with the site would be awesome. Note that the gallery does not have to stay in piwigo. It's really just meant to be a convenient place to see a curated set of interesting images and could be managed in many different ways. Note that most of our most recent images aren't even in the gallery -- they're on the facebook page. So lots of disconnect. It'd be nice if images could be somehow synced automatically, or pulled from facebook manually, or posts to the website gallery also post to facebook, etc. Don't know what are options are there.
Yeah Vercel is awesome, All these features and just 2-3 mins time to set it up
For the gallery part, I am thinking of a custom gallery integrated directly inside the Next.js project,
I am just able to imagine the part where we can have all the basic features like nested images (Categorized images in a folder), Search using image name, tags, and description. Meaning all the basic features Piwigo provides us currently.
For the Facebook part, according to my past experiences with their API, it was horrible, They don't love developers I guess :grinning_face_with_smiling_eyes: but how about if we can add a button below every image which will auto-generate a shared post for facebook whenever we click on it?
On the same note, I also wanted to mention that this update would mean if we want to add images to the platform that has to be done via committing the code directly to the GitHub repo, the reason being no backend API is involved, we can discuss on that part and if we are okay with that we can add it in phase 3 of the current GSOC and in other cases we can pick a better image gallery manager and update it to look alike our project
Views?
CC @Sean
Divyanshu Garg said:
New PR on the line
https://github.com/divyanshugarg36/brl-cad-web/pull/8
@Divyanshu Garg I think we should move the discussion of using flex and font mixing ahead. The code is getting lengthy without them. I have tagged you there with the reply.
Added replies @Amanjot Singh
New PR on the way
https://github.com/divyanshugarg36/brl-cad-web/pull/13
New PR on the line
https://github.com/divyanshugarg36/brl-cad-web/pull/16
@Amanjot Singh this one is for the flex mixing we are discussing
Will do same for font families in another PR
@Divyanshu Garg can you add me as a collaborator in the project. I believe we should use labels like Pending Developer Action
and Pending Reviewer Action
I am not able to use any label atm. This can help us understand the status of PR from the outside. Also, I will review the pending PRs soon
I have added replies to your PRs
@Amanjot Singh Added contributor and added some replies
thanks, will check that today
I was traveling for two days continuously and got sick. I might be taking rest for a day or two. Will jump back in here after I'm good again.
@Amanjot Singh if you need help in anything like reviewing code etc, just assign me and I will do it.
That would be great @Inder Singh thank you for extending the help. @Divyanshu Garg can send you the links of PRs that require code reviews.
Take care @Amanjot Singh
And Thank you for chiming in @Inder Singh
Here is the link to the repo
https://github.com/divyanshugarg36/brl-cad-web/pulls
These are the PRs that are reviewed and fixed but require approval
https://github.com/divyanshugarg36/brl-cad-web/pull/2
https://github.com/divyanshugarg36/brl-cad-web/pull/3
https://github.com/divyanshugarg36/brl-cad-web/pull/8
https://github.com/divyanshugarg36/brl-cad-web/pull/12
https://github.com/divyanshugarg36/brl-cad-web/pull/16
This one is new
https://github.com/divyanshugarg36/brl-cad-web/pull/17
Okay i don't think i can approve but would definitely go through the one and point things out .
@Divyanshu Garg I have added few comments in the new PR https://github.com/divyanshugarg36/brl-cad-web/pull/17/files
Most of the code is great, there were just a few questions and suggestions I had.
Thanks, @Inder Singh for the review, I will push some updates to fix some of the issues
New PR for review https://github.com/divyanshugarg36/brl-cad-web/pull/20
@Divyanshu Garg okay will look into it.
Sent PR fixes and new PR on the road
https://github.com/divyanshugarg36/brl-cad-web/pull/26
Will check them in some time today
Divyanshu Garg said:
Yeah Vercel is awesome, All these features and just 2-3 mins time to set it up
For the gallery part, I am thinking of a custom gallery integrated directly inside the Next.js project,
I am just able to imagine the part where we can have all the basic features like nested images (Categorized images in a folder), Search using image name, tags, and description. Meaning all the basic features Piwigo provides us currently.
For the Facebook part, according to my past experiences with their API, it was horrible, They don't love developers I guess :grinning_face_with_smiling_eyes: but how about if we can add a button below every image which will auto-generate a shared post for facebook whenever we click on it?
On the same note, I also wanted to mention that this update would mean if we want to add images to the platform that has to be done via committing the code directly to the GitHub repo, the reason being no backend API is involved, we can discuss on that part and if we are okay with that we can add it in phase 3 of the current GSOC and in other cases we can pick a better image gallery manager and update it to look alike our projectViews?
CC Sean
Hey @Sean
Can you please share your views on this?
New PR https://github.com/divyanshugarg36/brl-cad-web/pull/27
Great job @Divyanshu Garg I have added new comments on the PRs and approved the older ones with resolved comments.
Fixed issues @Amanjot Singh
Awesome, will check that
I checked the PRs and approved the solved ones yesterday, and maybe you have merged them as well.
I have also added comment to the last PR opened
I saw a small issue with some background colors and little spacing. I have opened the issue here. https://github.com/divyanshugarg36/brl-cad-web/issues/28
I believe before moving ahead let's plan out the issues (12) which we have pointed out in the application and might be needed to be resolved soon.
Sure @Amanjot Singh I will push an update asap
@Amanjot Singh as the site is almost complete. I was wondering what our plan is to get it deployed? making it up and running on brlcad.org
working on getting accounts established for both of you so you can do that. as soon as amanjot's set up, I'll be in touch with you for your account procedure.
Okay :grinning_face_with_smiling_eyes:
Excited about the deployment part :handball:
it sounds like there will likely be some details to discuss because part of this will likely involve figuring out how to deploy the set up without relying on a 3rd party service, or to understand and discuss the implications in much greater detail. 3rd party services are great for development, demo, staging, but not something typically desired for main website servicing.
the website is also going to need to integrate seamlessly with the doc site generation, and that all needs to work offline too. that was part of the reason for discussing static options early on.
BRL-CAD is deployed to networks without Internet access, so we want to keep that restriction in mind or have a plan for how it'll be serviced if it's different.
Yeah, once @Divyanshu Garg is up and ready with the server thingy we will move ahead. We can then move to setup the deployment with CI/CD
Another complication is that Vercel works for single user dev testing but technically BRLCAD as a project is not eligible for their hobby tier. Open source is by definition also commercial software, so their choice of terms there is unfortunate. That means any individual dev can use it (eg you) but “we” cannot without reaching out to them about their non-commercial license term as it pertains to open source.
For the deployment part
We don't need to use Vercel
I just checked Next.js is based on MIT license
We can just clone the code on the server and generate an offline static build without requiring the internet (We will need some for installing node packages) but once all those packages are there its good to go with a single command
Another PR https://github.com/divyanshugarg36/brl-cad-web/pull/31
I have requested some changes. Please have a look
Updated the PR
Another one https://github.com/divyanshugarg36/brl-cad-web/pull/32
For deploying this awesomeness, plan to first stage into https://beta.brlcad.org and not yet affect the main website as we'll need to ensure it's 1) going to and pulling from repo, 2) properly self-staged for review, and 3) covers all the necessary bases
@Divyanshu Garg can you create dev branch so that we can make the flow of development in a way that dev is staging and main is production. We will send code to dev and after the review it can go to production. Since this is a long term project for BRL-CAD having a good development flow is kind of necessity. Let me know if you need more information on this.
Some feedback on what I'm seeing in the latest PR: 1) the moving polylines are displayed while scrolling down and it seems like an error / is distracting -- they do disappear once scrolled to the very bottom, 2) the About Us section is wildly out of date information, probably best to combine with the next section and drop the old items, 3) Our Projects text is redundant with What is BRL-CAD, 4) instead of Our Projects page, perhaps we frame that page as a Repos page or similar since we will need a projects page that is more curated and product-based.
Sean said:
Some feedback on what I'm seeing in the latest PR: 1) the moving polylines are displayed while scrolling down and it seems like an error / is distracting -- they do disappear once scrolled to the very bottom, 2) the About Us section is wildly out of date information, probably best to combine with the next section and drop the old items, 3) Our Projects text is redundant with What is BRL-CAD, 4) instead of Our Projects page, perhaps we frame that page as a Repos page or similar since we will need a projects page that is more curated and product-based.
I will detail this feedback in GitHub issues. Thanks for the feedback @Sean :raised_hands:
Sean said:
Some feedback on what I'm seeing in the latest PR: 1) the moving polylines are displayed while scrolling down and it seems like an error / is distracting -- they do disappear once scrolled to the very bottom, 2) the About Us section is wildly out of date information, probably best to combine with the next section and drop the old items, 3) Our Projects text is redundant with What is BRL-CAD, 4) instead of Our Projects page, perhaps we frame that page as a Repos page or similar since we will need a projects page that is more curated and product-based.
Thanks for the feedback @Sean
This will help alot to make changes and fix things
Amanjot Singh said:
Divyanshu Garg can you create dev branch so that we can make the flow of development in a way that dev is staging and main is production. We will send code to dev and after the review it can go to production. Since this is a long term project for BRL-CAD having a good development flow is kind of necessity. Let me know if you need more information on this.
Yeah i just made the branch and directed the PRs to dev branch
Congratulations @Divyanshu Garg on passing your evaluation. You are doing a great job. Let's jam on the further things and lit them up as well. :fire: :praise:
Thanks @Amanjot Singh and whole BRL-CAD team
Just wanted to inform that i am little sick so i will be back to forces in a day or 2
No problem @Divyanshu Garg take proper rest and come back stronger
Hey @Sean @Amanjot Singh
I just checked the server and cloned the new repository
But found that we have node 17 installed there and npm is not
Should I go ahead and install node 14 and npm? or we can also use NVM
I think it's better to install nvm instead of installing node directly.
NVM didnt worked on the server, it started a long process of compilation and didnt got to final stage for like 5 mins then i cancled it
thinking of another way
Can i use sudo to install the npm setup package?
Can you provide more details and/or a log file? What was it doing during that time?
I just installed npm.
I dont have an exact log, because after it went wrong I did a clean uninstall of nvm
But for installation
I just ran curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.1/install.sh | zsh
and after that, it started using c and cpp to compile files
I made the build successfully
I think to deploy this we need to forward 500 port to beta
I moved to the tasks we have to do in phase 2
I cloned the repo and installed it
Then I saw the build process and followed it and it generated a static documentation site
Not what I see in this one is to change the theme to match the main project, so will be looking at it how we can achieve that
Apart from that @Sean , I used npm to start the project and it did work but I think there were some dependencies issues so we might need nvm to setup the project, and there are 2 options for us at this point for deployment
and I think we should go with 1
@Amanjot Singh we do have some PRs pending in main project. might need to take a look at them
@Divyanshu Garg I will review them today. Thanks for reminding
Added some comments @Divyanshu Garg Please check them on GitHub
@Divyanshu Garg Good news for you :wink: I thought getting engaged with the deployment would take your focus away from the application and actual code. So I talked with Erik and we think you can solely focus on writing code and adding new ideas to the project. I will be working on the deployment process alongside (most probably on the weekend)
I think this will help you create clear goals for this phase. Let me know if you need any help with that.
Oh, that's great,
But there's one thing I wanted to confirm about this phase, which is I have tested and understood the documentation repo we want to make live, but I saw that it automatically generated a static site that can be deployed directly, if we talk about its integration with main project its just a matter or adding a new URL in navbar or footer, Is this something we want to achieve?
Most probably yes but still I will confirm that soon. Meanwhile, you can work on the Gallary idea that you shared earlier.
Yeah that would be a great idea to start the gallery module, Its just I will need to create a plan and do some research on how we can make a manageable gallery tool, I will check it out and post an update...
Divyanshu Garg said:
Oh, that's great,
But there's one thing I wanted to confirm about this phase, which is I have tested and understood the documentation repo we want to make live, but I saw that it automatically generated a static site that can be deployed directly, if we talk about its integration with main project its just a matter or adding a new URL in navbar or footer, Is this something we want to achieve?
Yes, that's the general idea, but not all that is needed. The new doc repo generates a static set of files, but that'll need to seamlessly integrate with the website in both styling and organization. Initial integration can be very simple, just drop it in and link to it, but that's only the start . It needs to not look like a totally separate site and ideally should not duplicate information. For example it might make sense to turn the previous "features" pages into doc pages. Or maybe the gallery images should reside in the docs repo as a showcase, and the website repo processes it down and integrates it all together. Or maybe we keep the gallery separate like it is, but then we will need to document everything clearly as to how things get edited and revision controlled.
Divyanshu Garg said:
Apart from that Sean , I used npm to start the project and it did work but I think there were some dependencies issues so we might need nvm to setup the project, and there are 2 options for us at this point for deployment
- We can use port forwarding to deploy the build because this will allow us to take advantage of most of nextjs features
- We can make static build using which we can deploy the files directly but will loose most of nextjs features
and I think we should go with 1
What features would we lost? A static site is going to be more performant and will likely work better for non-public deployment or environments where javascript is disabled.
Thanks for the clarity @Sean
I will update the documentation template and make sure that it looks as same as the main project UI
@Sean
These are the features we will miss out if we generate a static one
Started working on the docs repo to match the UI will be sending a PR soon
For the Footer part i am thinking that same footer can be used but for header there might be some difference so will figure that out
image.png
@Amanjot Singh @Sean
These are the changes I made to make the documentation site and main project look alike
Luckily both projects are using same fonts roboto.
Added some theme colors and more
Please share your views
If this gets a greenlight then I can also add an identical footer
Divyanshu Garg said:
image.png
Amanjot Singh Sean
These are the changes I made to make the documentation site and main project look alike
Luckily both projects are using same fonts roboto.
Added some theme colors and morePlease share your views
Looking good to me :fire: Let's wait for Sean to confirm this one as well
@Divyanshu Garg I have reviewed and approved both the PRs on GitHub. Do you have anything in your plate now?
Yes, For the documentation site i have the plan ready for the part where we want to make the theme similar to our main project
For the main project I have been figuring out some things to make some updates we discussed last time
Divyanshu Garg said:
Yes, For the documentation site i have the plan ready for the part where we want to make the theme similar to our main project
Can you elaborate a little more about the plan you are referring to for theme matching?
For the main project I have been figuring out some things to make some updates we discussed last time
Yeah let's plan the things that we can include ahead for the rest of the time in GSoC.
Yeah sure i have been keeping together some cards for a board so i will add them all on the project site github, or the documentation site github if i had the access
Sure. I think we should move further to the gallery section. If there's anything pending on the documentation site theme you can create issues about that. Let me know if you need any input from me on this.
We have a few days left for this. Let's plan this today and start jamming
Yeah i am already working on the plan and will be sharing it today
Yes, also let's finish up the theme match task. You make changes according to https://brlcad.zulipchat.com/user_uploads/1549/2BG0E1QtyxZzwdFIx7sJ-vaY/image.png image you shared.
Sure, thanks for the confirmation
https://github.com/divyanshugarg36/brl-cad-web/projects/3?add_cards_query=is%3Aopen
Plan for theme
https://github.com/divyanshugarg36/brlcad-docs/pull/1
Opened a PR
@Amanjot Singh I have added you as a collaborator in this fork
once we are done with code i will send a PR from forked main to main
Great! I'll check them tomorrow morning. Thanks for putting your hard work on this man. Will get back to you on this tomorrow.
Second PR
https://github.com/divyanshugarg36/brlcad-docs/pull/2
@Divyanshu Garg nice job. I reviewed the first PR and will review the second one by today evening.
Thanks for the review @Amanjot Singh
@Amanjot Singh I have sent updates on both new PRs and now I am looking for the existing gallery implementation, I am thinking what if we can add new theme to the gallery which will allow us to have all the existing features and it will look integrated with the main project site
what do you suggest?
Yes, you can make that experiment. In the end, we are looking for things to have an overhauled design and look. I think if just adding a new theme to the existing gallery would work, we should go for it.
I think the coding period is ending this week. Let's jam on that and see if working on that is feasible in this short time span.
PS other than the gallery do you have any other ideas for the website? Also, we have to figure out if it's possible to finish the gallery by the end of this week.
@Amanjot Singh I have some UI plans for this one, as its already there and wont take a lot of time meaning it might be doable in 1 week,
https://brlcad.org/gallery/
I just need the exact repository for this deployment then i can check what things needs to be done for making this UI better
@Erik do you know, from where we can access the actual code where the gallery is implemented?
cc: @Sean
@Amanjot Singh do we have any update?
With the current status, I am left with some issues in GitHub so I will start working on them
Yeah, we didn't get the confirmation yet. You can shift to GitHub issues.
Sean said:
Some feedback on what I'm seeing in the latest PR: 1) the moving polylines are displayed while scrolling down and it seems like an error / is distracting -- they do disappear once scrolled to the very bottom, 2) the About Us section is wildly out of date information, probably best to combine with the next section and drop the old items, 3) Our Projects text is redundant with What is BRL-CAD, 4) instead of Our Projects page, perhaps we frame that page as a Repos page or similar since we will need a projects page that is more curated and product-based.
@Divyanshu Garg I saw you already have these issues in GitHub but I couldn't find 3 & 4 there. Did you fix them already?
Yeah, 3 and 4 were both fixed
@Amanjot Singh all PR comments are fixed for brlcad-docs
https://github.com/divyanshugarg36/brl-cad-web/pull/39
new small one to fix issue
@Amanjot Singh https://github.com/divyanshugarg36/brl-cad-web/issues/34
I have been thinking about this issue
Do we have a place where we can get latest BRL information which we can add here
Divyanshu Garg said:
Amanjot Singh https://github.com/divyanshugarg36/brl-cad-web/issues/34
I have been thinking about this issue
Do we have a place where we can get latest BRL information which we can add here
I think @Sean or @Erik can confirm this one. Spoiler alert, this is about latest information for about us
section.
@Divyanshu Garg I'm a little engaged with some personal errands. I have yet to work on the deployment thingy. So, giving you a heads up that you can use your repository link as the showcase work for GSoC evaluation (just in case you need it). Throwing this information a little proactively so that you don't get blocked because of this. If you have any question or doubt hit me up.
Thanks for the heads up @Amanjot Singh
Divyanshu Garg said:
Amanjot Singh https://github.com/divyanshugarg36/brl-cad-web/issues/34
I have been thinking about this issue
Do we have a place where we can get latest BRL information which we can add here
Not really. There's lots of information in many different places. The about-us page was taken from "Vol I" which no longer exists as a guide but the relevant information was extracted to the website. There's really good information in our contributor's guide ( https://archive.flossmanuals.net/contributors-guide-to-brl-cad/ ) and it's probably the most up-to-date and intentionally written, but it's certainly not what I'd call the "latest"
This PDF gives a graphical overview, but doesn't really provide explanation -- lots of images that can be reused though. https://brlcad.org/BRL-CAD_Overview.pdf
Thanks for the information @Sean
I will try to figure out what information from these links is relevant for the project site and if it didn't worked out then we have the option to eliminate or merge this block
Congratulations @Divyanshu Garg on clearing GSoC 2022. I did a great job. Looking forward to jam on more things after this huge milestone :fire::clink: keep rocking
Amanjot Singh said:
Congratulations Divyanshu Garg on clearing GSoC 2022. I did a great job. Looking forward to jam on more things after this huge milestone :fire::clink: keep rocking
OOOOPSSSSSS I wrote You did a great job
as I did a great job
:joy: I'm really sorry for this typo man it's all your hard work
Yeah :joy:
Thanks @Sean @Daniel Rossberg @Amanjot Singh
It was great working with you all and I will keep contributing and make more improvements
Thanks for offering the role of web admin, I would love to know my responsibilities for this :grinning_face_with_smiling_eyes:
Started working on https://github.com/divyanshugarg36/brl-cad-web/issues/34
And started putting together some details
We can try changing the info once and see if it looks good,
Else we can hide this block
@Divyanshu Garg I have approved the 3rd PR of docs repo. Let me know if there is anything else left.
Thank you for the update @Amanjot Singh
Here is the final PR for merging the changes in the main repository
https://github.com/BRL-CAD/brlcad-docs/pull/52
CC @Sean
Please let me know it we need to make any changes in this
Hey, @Amanjot Singh @Sean
https://github.com/divyanshugarg36/brl-cad-web/pull/41
A new PR for the main project site
This updates the about us section with the somewhat latest information as shared earlier
Please have a look if this is okay, else we can plan to merge this block with some other block
@Divyanshu Garg thank you for the hard work. I will be reviewing them after this weekend.
@Divyanshu Garg I have reviewed the pending PRs. Let me know if there is anything pending now
Thanks @Amanjot Singh
I will update asap!
Now that things are starting to settle back down, it'd be great to push this work live. Is there a final punch list? (i.e., a list of any details remaining to make it final)
Hey @Sean
I think this build can be deployed on the live server
And the final punch list was related to some pending reviews and issues which are already fixed
(I do have some more ideas which I will start working on once we are done with the deployment)
I do need to update that copyright year in the footer which I will send a PR for
https://brl-cad-web.vercel.app/ This is the dev deployment link for the latest build.
Please review this when possible and let me know if we need to fix something, I will move to deployment after this
:grinning_face_with_smiling_eyes:
CC @Amanjot Singh
@Amanjot Singh Here is the final PR before deploying the project
Please have a look https://github.com/divyanshugarg36/brl-cad-web/pull/43
Hey @Divyanshu Garg I have approved this one. You can merge this now
I think we are good to go with the deployment process
I will collaborate with @Amanjot Singh to get this site live
@Sean do we have the green light? :grinning_face_with_smiling_eyes:
https://brl-cad-web.vercel.app/
Here is the link to final build
You do! This looks really fantastic guys. Nice work, especially cleaned things up on mobile.
Thank you :raised_hands:
I will try to be careful while deploying this
Is there anything specific I need to take care of before doing this?
Let me know if you need help with the deployment or with permissions but should both have access I believe. If not, we can fix that too. Do retain/archive all the old site files just in case. They can reside in a folder like the beta sites.
Nothing specific comes to mind. It’s not talking to a database, right?
No database
I will keep a backup of everything we update and of course move the current site to beta or any other similar place
Didn’t think so.. but that’d be the only issue that could cause complications I can think of.
Then I think its all good
I will try to get this done asap
Perfect timing. :)
Divyanshu Garg said:
Looks clean and simple. Good design. :tada:
btw linkedln link directs to Sean profile. :thinking:
Divyanshu Garg said:
Awesome, I also think it's the perfect time to make this website live :D
Let's get this done in this week. I'm EXCITED!!!
Himanshu Sekhar Nayak said:
btw linkedln link directs to Sean profile. :thinking:
Thanks @Himanshu Sekhar Nayak :grinning_face_with_smiling_eyes:
Yeah It does but the URL says https://www.linkedin.com/in/brlcad, so I m thinking this one is intentional
Amanjot Singh said:
Divyanshu Garg said:
Awesome, I also think it's the perfect time to make this website live :grinning:
Let's get this done in this week. I'm EXCITED!!!
Awesome!
Can't wait getting this done :grinning_face_with_smiling_eyes:
Screenshot-2023-02-09-at-1.46.04-AM.png
Just tested performance using lighthouse, Currently deployed on testing server :grinning_face_with_smiling_eyes:
I am still not completely okay with those yellow circles
Will send an update soon to make em all green :grinning_face_with_smiling_eyes:
Those are both debatable, but certainly won’t typically hurt to get them all green.
Will be informative to compare with performance on our brlcad.org hardware.
We have a new server that is much faster but I’ve not yet completed the migration.
The performance is kind of similar
Screenshot-2023-02-09-at-1.55.28-AM.png
Looks like half the speed
Half to a third
But maybe apples oranges as it’s not the same aite
Site
Yep :grinning_face_with_smiling_eyes:
Sean said:
We have a new server that is much faster but I’ve not yet completed the migration.
So if the site is deployed on the current server, then its automatically migrated on the newer one right?
Yeah I run a sync script
Great!
That’s part why the migration isn’t finished. The validation takes a really long time.
Plus just so busy .. need to get back in it asap
Yea, server migrations can be a lot more painful, and even more if the data is huge
https://github.com/divyanshugarg36/brl-cad-web/pull/46
Here is the performance PR :stuck_out_tongue:
this increases the score more
Screenshot-2023-02-09-at-12.03.09-PM.png
Latest scores
@Amanjot Singh
https://github.com/divyanshugarg36/brl-cad-web/pull/48
Another PR for upgrading the nextjs version
Hey @Sean
I have successfully deployed the project on https://beta.brlcad.org/
Currently, we have to work on image optimization as after creating apache compatible build we lost the automatic image optimization capabilities that Next.js provides, Not a big issue.
Will move to brlcad.org tomorrow...
Uploading Screenshot 2023-02-11 at 2.10.54 AM.png…
Here are the scores
Deploying :grinning_face_with_smiling_eyes:
Finally, the site is deployed!
It feels so amazing getting this all done.
The previous one is backed up inside old_backup_2021
AMAZING JOB @Divyanshu Garg !!! It's looking so great :fire:
PS I have approved the last PR that you made ready yesterday. You can merge that as well.
Hi, this is Komal Sambhus, a student from Mumbai, India. I am interested in participating in GSoC 2023 from BRL-CAD. Can anyone give me some resources or good first issues to start with since I am new to Open Source? Thank you in advance
Komal S said:
Hi, this is Komal Sambhus, a student from Mumbai, India. I am interested in participating in GSoC 2023 from BRL-CAD. Can anyone give me some resources or good first issues to start with since I am new to Open Source? Thank you in advance
Hi Komal. Welcome to our organization.
First you should start with installing the BRL-CAD programs. You can find the installation packages at https://sourceforge.net/projects/brlcad/files/. Go through the mged tutorial https://brlcad.org/w/images/c/cf/Introduction_to_MGED.pdf which is an old GUI where you will get to know how to create primitives, assign material properties, and ray tracing and many more.
Gain an overview of the existing documentation at https://brlcad.org/wiki/Main_Page.
To start with programming download the source code from https://github.com/BRL-CAD/brlcad and compile and install the programs (https://brlcad.org/wiki/Compiling). You can use https://brlcad.org/wiki/Deuces as a starter for small programming tasks.
If you have a question, don't hesitate to ask. We will be happy to help.
Btw move to other channel if you have anything to ask.
BRL-CAD Web Repository upgraded https://github.com/divyanshugarg36/brl-cad-web/pull/49
Hey @Amanjot Singh
If you are available, can you please give this PR a review?
We can merge this and deploy the latest update on the server
I am also planning some new changes and improvements to the project will create some issues soon and start working on it
Sure, @Divyanshu Garg I will check this out today. Thanks for the PR
@Divyanshu Garg I merged that PR yesterday. Good job with the upgrade to the new version of Next.
@Divyanshu Garg Have you had a chance to look at integrating the new docs site with the website? This was the work Dashamir worked on right around the same time as your project.
@Sean I havent checked it yet, but I will look for it on Github and send some updates
Hey @Sean can you please share the documentation content we discussed during the meeting?
@Divyanshu Garg yes, it's at https://github.com/BRL-CAD/brlcad-docs/tree/main and I believe this is the latest deployment is live here: https://brl-cad.github.io/docs/
The site is currently a fork of the docs, so we'd need to figure out how to unify them -- e.g., delete from the main repo but then still have a simple means to generate the necessary manual pages and other products for source/binary builds off the main repo.
Here is a glance at the pointers and planning of the updates that were discussed over the call
I will be updating this document with more brainstorming ideas.
https://jerrymouse.notion.site/BRL-CAD-Web-Plan-2024-f21d06cb8d7f4a5cab102783c167670e
Feel free to drop comments for more inputs :grinning_face_with_smiling_eyes:
CC @Sean @Amanjot Singh
(deleted)
Himanshu said:
Vidit Jain said:
I was trying to use the select primitive feature of arbalest. For me its working fine.. can you tell me what exactly the issue is?
I am thinking of taking up that issue next. If you all want we can work on something else as well. Himanshu Daniel Rossberg Amanjot SinghYes, the mouse select option is working I saw it today. It doesn't work for me when it is full screen idk why but works fine when I restore down.
Yaa, for me as well sometimes its working and sometimes its not. Its very weird
Just a minor update on the issue we are facing with the deprecated packages in the gallery section
I just tested out the latest version the of library we are using to manage pictures...
Will update/replace the existing build with the latest version.
Hey @Sean
I am working on updating the piwigo deployment for the gallery
Can you please share the admin creds of the deployment so that I can test it out before and after updating...
Thanks
Thank you for offering! I think you already have access on the server side, but I will check.
Hey Sean, i meant the Piwigo admin credentials, i do have the server access
Hey @Sean pinging for this :point_up:
Thanks!
The server is getting slow, like a turtle slow
Took me 1+ hour to zip 800mbs of data :tear:
image.png
:tear: Already running for past 40 Mins
Last updated: Nov 15 2024 at 00:49 UTC