In honor of Hacktoberfest, the Forem team is actively looking for open source contributors to help improve our projects! The goal? To expand and improve Forem for the entire community while helping contributors achieve their four pull-request benchmark for Hacktoberfest!
Participants can use this list as a reference for the current projects Forem is seeking contributions on. 🎉
Projects
/resource_admin
migrates to /admin
In the past, Forem has used two areas to take administrative action. As we continue to build out Forem, having two separate areas with similar functionality no longer makes sense, so we’ve been working towards consolidating the two admin panels.
We will be removing the administrate gem that powers resource_admin
and want to bring all features into /admin
.
Original Issue
Move Admin interface paths #9576
What type of PR is this? (check all applicable)
- [x] Refactor
- [ ] Feature
- [ ] Bug Fix
- [ ] Optimization
- [x] Documentation Update
Description
Moves admin interfaces from /admin
to /resource_admin
in order the clear the way for future movement of /internal
to /admin
. See issue forem/InternalProjectPlanning#5 for more details!
Next steps will be to:
- move
/internal
to/admin
- remove administrate, and move these interfaces back up under
/admin
Related Tickets & Documents
Part of forem/InternalProjectPlanning#5
Added tests?
- [x] yes
- [ ] no, because they aren't needed
- [ ] no, because I need help
Added to documentation?
- [x] docs.dev.to
- [ ] readme
- [ ] no documentation needed
[optional] What gif best describes this PR or how it makes you feel?
Check out this GitHub Project for more issues related to this project.
API Improvements
An improved API enables more people to build on the Forem ecosystem!
Articles API: filtering by tags.
Articles API: filtering by tags #3654
Is your feature request related to a problem? Please describe.
Describe the solution you'd like In response to #3509, we want to allow the API endpoint to filter by tags and include an 'anti-tag' list.
API: Return properties regarding series in GET request data.
API: Return properties regarding series in GET request data #3669
Is your feature request related to a problem? Please describe.
When creating articles using the API, it's possible to assign the article to a series. However, when querying for articles from the API, no information regarding series is made available in either the objects returned /api/articles/?=${queryString}
or the data returned from /api/articles/${id}
.
Describe the solution you'd like
Ideally, a series
property would be returned along with the rest of the data for each article from either endpoint with the title or some other identifier of the series to which the article belongs.
Describe alternatives you've considered
Additional context
Include video_source_url in the API.
Include video_source_url in the API #6299
Is your feature request related to a problem? Please describe.
Currently, the video_source_url field is not available for Videos in the API.
Describe the solution you'd like
Add the video_source_url to either the Video API or Articles API. The Video API would be my preference to prevent the need to query two API endpoints. But, either is workable.
Describe alternatives you've considered
Scraping the article for the video_source_url. But, I don't want to go down that route...
Breakdown Positive Reactions in the API.
Breakdown Positive Reactions in the API #6303
Is your feature request related to a problem? Please describe.
For building functionality into the Unofficial DEV Social Badge, it'd be nice to offer a breakdown of what the positive reactions are.
Describe the solution you'd like
Include the breakdown of the positive reactions in the articles API endpoints
Describe alternatives you've considered
Scraping. But, again, I don't want to go down that path.
Reading list API of an authenticated user
Reading list API of an authenticated user #6755
Is your feature request related to a problem? Please describe. Dev API doesn't have the option to list the authenticated user's reading list
Describe the solution you'd like Build an API to list user's reading list
Query organization on dev.to/api.
Query organization on dev.to/api #9212
Feature Request
Currently there in no way to query an organization on dev.to/api
Describe the solution you'd like
It would be nice to query https://dev.to/api/organization/articles, https://dev.to/api/organization/users, https://dev.to/api/organization/listings where organization is e.g., https://dev.to/api/vetswhocode
The description could read:
This endpoint allows the client to retrieve an organization .
"Organizations" is all the data that an organization creates on DEV that typically show up in the feed and a user is connected >to. They can be a blog post, a discussion question, a help thread etc. but is referred to as an organization within the code.
By default it will return featured, published articles ordered by descending date of publication
It supports pagination, each page will contain 30 articles by default.
Suggest or Implement a Liquid Tag!
Liquid tags have been a great differentiator and enhancement to our text editor. Now that we're expanding Forem to help power more communities, we'd love to introduce more liquid tags that aren't so developer-centric.
What kinds of tags would you like to see on Forem? Let us know in the comments!
Documentation
Good documentation is essential to the success and health of any open source project. If you see any issues, errors, or something you think should be added check out our “Contributing to the Docs” guidelines to contribute. A reminder that documentation changes should be a meaningful, value-add for the project.
Mobile Issues
If you are familiar with the Kotlin or Swift programming languages for mobile development, we have some open issues in our mobile app repositories. We would greatly appreciate contributions to make the experience of catching up with DEV on the go a little better for everyone.
Support for Ten X Hacker Theme in iOS app.
White Lines on Top and Bottom of App in Dark Mode #230
Describe the bug When using the app on iOS in dark mode, even though my phone is also on dark mode, the top and bottom "navbars" are of white color. Ruining the purpose of dark mode or theme.
Screen Shot attached: To Reproduce Steps to reproduce the behavior:
Open Dev App on iOS Change the theme to dark mode, Note the top and bottom of the app is while,
README enhancements for iOS app.
Add steps on how to install the app on a physical iOS device #50
Is your feature request related to a problem? Please describe. Not really a problem, but a request to include steps on how to install the beta app on an actual device as opposed to in the macOS Simulator App.
Its been a long while since I've done any native development, and I had to relearn all the quirks of allowing a development stage app to be installed on my iPhone. I think this will be the case in the future if there are more people coming in from DEV.to to check out and install the app (like me
Describe the solution you'd like A step by step guide in the README on how to get the app working on a physical device. (Not too bloated, links to the "gotchya" steps that have already been documented many many times on StackOverflow and similar)
Describe alternatives you've considered This could be put somewhere else in the repository, but I think in the README makes the most sense.
Additional context N/A
Bump the minimum SDK for the Android app.
Bump the project minimum SDK API #88
Is your feature request related to a problem? Please describe.
Some initial attempts bumping the project minimum SDK API haven't been successful, but it's still an important thing we want to do in order to give a better experience to users since we do rely on some calls that are not supported in the current minimum (API 18).
Describe the solution you'd like
At the moment targeting support for API 21 and above feels like the right balance between reaching as many devices as possible while making sure we are installing in devices that will get a good experience. An example of this is that WebView's evaluateJavascript
is only supported in API 19+ and we currently support a minimum 18 (which means they don't get Push Notifications and other features that rely on this).
Additional context
Contributions in the form of PRs are very welcome. Work on this issue may overlap with #87, just in case anyone is working on this it may be good to keep an eye on that one and see if conflicts may be avoided beforehand.
Remove highlight in Main Feed links from Android App.
Link highlighted #97
Describe the bug Through scrolling the news feed done links change there color without really clicking on them.
To Reproduce
- Go to news feed
- Scroll down
- Taping on link through scrolling (not enter)
Expected behavior Heighlght after kicking and entering the link.
Smartphone:
- Device: Huawei P10
- OS: Android
- Version: 9
Add build flavors to Android app.
Project directory restructure (Build Flavors) #87
Is your feature request related to a problem? Please describe.
We've recently felt that the current project directory structure is a little too complex for our needs.
Our currently modular project directory (data
, buildSrc
, baseui
, app
) feels more appropriate for native apps that benefit from Activity/Fragment/ect reuse. In our case we deal with very few moving parts.
Describe the solution you'd like
We're open at the moment to contributions where we can simplify our project directory structure. The ideal result is a minimal directory structure where we can easily work on enhancing our main Main Activity & browsing experience with the custom WebViewClient.
The suggested changes that we're looking to see in a PR for this are the following:
[x] Simplified directory structure
[x] Consider removal of databinding
[x] Keep integrations we already have in the project (i.e. refreshVersions)
[ ] Configuration of Build Flavors: To reduce contributors friction to spin up their local development and start working on the app we can provide a google-services.json
dummy file for debug/development (read more about this)
Additional context
PR's for this issue are very welcome. If you have a question or want to suggest alternatives feel free to leave a comment in this issue. We are open to hearing ideas on how to make our directory a minimal version of what we currently have.
Bug with Notifications in Android app.
App always crashes when accessing from the notification area #95
For about a week now, dev.to Android app always crashes when accessed from push message, i.e. Notification Area, on Vivo.
Actually, the first ever notification message is Wisdom engine "DEV Community" runtime exception. After I slided to hide that message, this error consistently happen.
To Reproduce
- A notification message is received.
- Click on the notification message
- App opens and dies without any visible UI or message
- However, app can still be accessed via clicking the icon. (And the notification count is still there.)
Expected behavior
No crashes.
Smartphone (please complete the following information):
- Device: vivo1910
- OS: Android version 10 / vivo ROM Funtouch OS_10
- Version: 1.4.1
Open Design Issues
If you prefer to flex your design skills check out this GitHub project card with open design issues
If you get stuck on what to work on, keep an eye out for our #hacktoberfest live-streams on Twitch! We’ll be holding these sessions on Mondays, Tuesdays and Thursdays throughout October where we’ll cover many of these projects and issues in more detail with different members of the Forem team.
See you on DEV and Twitch and Happy Hacktoberfest!
Top comments (5)
I would like to contribute a developer centric liquid tag. Also, I'm learning Ruby to implement this tag so my pull request might need to be reviewed before being merged. Is that okay?
Heyo!
I'm admittedly a non-developer, but on the DEV team. I'm sure that folks here would be happy to review your PR! And really cool to hear that you have an idea for a dev-centric liquid tag.
Hey! Just be sure to check out our contributor guide if you haven't already and then go for it! Someone on the team will review it. I don't think it will be a problem if the tag is developer centric. Thanks for checking!
We have a specific docs page for liquid tags, go for it!
docs.forem.com/frontend/liquid-tags/
Cool! I wasn't even aware that you had mobile apps at all ... :-)